JAPS2ME

Just A PS2 Memory Card Editor is a command-line tool for managing PCSX2 PlayStation 2 memory-card images. It can list and delete save directories and import CodeBreaker .cbs saves.

Early development: Back up your memory-card image before using JAPS2ME. Avoid editing a card while it is open in PCSX2. Although imports are staged and validated before replacing the image, keep an independent backup.

Features

List save directories in a memory-card image.
Delete a save directory.
Import a CodeBreaker .cbs save, including its files and metadata.
Read and update standard PS2 memory-card images with ECC support.

Build

You need a Rust toolchain with Cargo installed.

cargo build --release

The executable is created at target/release/japs2me.

Usage

japs2me list <CARD.ps2>
japs2me delete <CARD.ps2> <SAVE-DIRECTORY>
japs2me add <CARD.ps2> <SAVE.cbs>

Examples:

target/release/japs2me list Mcd001.ps2
target/release/japs2me add Mcd001.ps2 my-save.cbs
target/release/japs2me delete Mcd001.ps2 BASLUS-20787SD5

list displays save directory names and their directory-entry counts. add uses the directory name stored in the CodeBreaker save and will report an error if that save already exists on the card.

Tests

Run the test suite and lint checks with:

cargo test
cargo clippy --all-targets -- -D warnings

License

JAPS2ME is licensed under the GNU General Public License, version 3 or (at your option) any later version (SPDX: GPL-3.0-or-later).

Acknowledgements

Thanks to Adubbz and the mymcplusplus project, a Python PS2 memory-card manager. Its implementation provided a valuable technical reference for understanding the PS2 memory-card filesystem format and behavior.

1.8 KiB Raw Blame History