JAPS2ME - (Just A PS2 Memory Card Editor) is a command-line tool for managing PCSX2 PlayStation 2 memory-card images.
Find a file
2026-10-07 14:54:54 -04:00
src Add Datel Max Drive save support, decouple file operations from just codebreaker format 2026-10-07 14:54:54 -04:00
.gitignore Add Datel Max Drive save support, decouple file operations from just codebreaker format 2026-10-07 14:54:54 -04:00
AGENTS.md Add Datel Max Drive save support, decouple file operations from just codebreaker format 2026-10-07 14:54:54 -04:00
Cargo.lock Initial Commit, supports editing PS2 mem cards and adding codebreaker saves 2026-10-07 13:13:52 -04:00
Cargo.toml Initial Commit, supports editing PS2 mem cards and adding codebreaker saves 2026-10-07 13:13:52 -04:00
README.md Add Datel Max Drive save support, decouple file operations from just codebreaker format 2026-10-07 14:54:54 -04:00

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 and Datel MAX Drive .max 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.
  • Import a Datel MAX Drive .max save, including LZARI decompression.
  • 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|SAVE.max>

Examples:

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

list displays save directory names and their directory-entry counts. add detects CodeBreaker and MAX Drive saves by their file signatures, uses the directory name stored in the save, and reports 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.