Skip to content

Crossplatform cli utilities for working with PSX memory card files

License

Notifications You must be signed in to change notification settings

G4Vi/psx_mc_cli

Repository files navigation

psx_mc_cli

Crossplatform cli utilities for working with PSX memory card files

Setup

Install from CPAN [Recommended]

cpanm PlayStation::MemoryCard will install it including adding the tools to PATH

Or Download standlone release and add to PATH

Download psx-mc-cli-v*.*.*-standalone from releases and extract.

*nix

Add bin_sh to PATH, export PATH=$PATH:wherever/psx_mc_cli/bin_sh. In Debian you'd likely put it at the bottom of ~/.profile .

Windows

Git for Windows comes with Perl, but otherwise Strawberry Perl is recommended. For using the utils from Git BASH see the *nix notes to add it to that PATH.

For using the utils from outside of a *nix environment (cmd.exe, etc) add perl and bin_cmd to your PATH. Start -> View advanced system settings -> Advanced -> Environment Variables select Path and edit.

Or Download APPerl binary

psx_mc_cli is available as an APPerl application! A self-contained binary with Perl and psx_mc_cli that runs on Windows, Linux, Mac OS X, FreeBSD, OpenBSD, and NetBSD. See psx_mc_cli.com in releases. Run with --help for usage info, it can be used with the same convenience as the other setup methods after install. See above for how to add a dir to PATH.

Usage

With all commands the input filename - refers to stdin and only one file will be read from stdin. It CAN be combined with other filenames however.

mkmcd BESLEM-99999TONYHAX tonyhax.mcs card1.mcd > out.mcd to make a psx memory card .mcd file from save(s) in .mcs, .mcd, and raw saves.

lsmc card.mcd thps2-us.mcs BESLEM-99999TONYHAX to print info of save(s) included in .mcd, .mcs, and raw saves. For convenience is no files are provided, read file from stdin (-) is implicitly done.

raw2mcs RAWSAVE > out.mcs to convert a raw save to .mcs. Add -o NAME if you need to override the filename to be stored in the .mcs.

mcs2raw in.mcs to convert a .mcs to a raw save. Add -p PATHNAME to set the output filepath (note this doesn't store the save filename) OR add -d OUTDIR to set where to store the raw save.

mcsaveextract card.mcd [savesubstring] > thps2-us-copy.mcs to extract single saves as .mcs from .mcd mciconextract thps2-us.mcs [savesubstring]> thps2-us.tim to extract the save icon as TIM.

If .mcd is provided without savesubstring the first save is extracted. The savesubstring param is only used for .mcd, it can be the string or case insensitive substring of the save's filename i.e BESLEM-99999TONYHAX or title i.e. TONYHAX SPL or title in ascii if applicable i.e. TONYHAX SPL

mciconextract can also dump the icon as a .gif with --gif [optionalscalevalue]. To dump the Color LookUp Table and pixels of the save icon as C source code, pass --csrc.

LICENSE AND COPYRIGHT

This software is copyright (c) 2021-2022 by Gavin Hayes.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. See LICENSE.

Wanted

  • automated tests
  • lsmc
    • nonverbose mode
    • direntry only mode
    • Improve terminal save icon graphics

About

Crossplatform cli utilities for working with PSX memory card files

Resources

License

Stars

Watchers

Forks

Packages

No packages published