Bring name in line with JAPS2ME
This commit is contained in:
parent
11404959e5
commit
748a26b8b3
5 changed files with 31 additions and 21 deletions
|
|
@ -2,7 +2,7 @@
|
|||
name = "japs1me"
|
||||
version = "0.1.0"
|
||||
edition = "2021"
|
||||
description = "JAPS1ME - PS1 RetroArch Save Converter (DexDrive .gme to RetroArch .srm)"
|
||||
description = "JAPS1ME - Just A PS1 Memory Card Editor (DexDrive .gme to RetroArch .srm)"
|
||||
license = "GPL-3.0-or-later"
|
||||
|
||||
[dependencies]
|
||||
|
|
|
|||
37
README.md
37
README.md
|
|
@ -1,9 +1,10 @@
|
|||
# JAPS1ME
|
||||
|
||||
**JAPS1ME - PS1 RetroArch Save Converter** is a command-line tool for converting
|
||||
DexDrive PlayStation 1 memory-card images (`.gme`) to RetroArch memory-card
|
||||
format (`.srm`). It also lists the saves on `.gme` and raw (`.srm`/`.mcr`)
|
||||
card images.
|
||||
**JAPS1ME - Just A PS1 Memory Card Editor** is a command-line tool for managing
|
||||
PlayStation 1 memory-card saves for RetroArch-style emulators. It converts
|
||||
DexDrive (`.gme`) card images to RetroArch (`.srm`) format, lists the saves on
|
||||
`.gme` and raw (`.srm`/`.mcr`) card images, and imports, deletes, and installs
|
||||
saves and cards.
|
||||
|
||||
## Features
|
||||
|
||||
|
|
@ -45,14 +46,6 @@ target/release/japs1me delete mysaves.srm BESLES-03946PES-OPT
|
|||
target/release/japs1me install mysaves.srm
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```sh
|
||||
target/release/japs1me list save-games/pro-evolution-soccer-2.22507.gme
|
||||
target/release/japs1me convert save-games/pro-evolution-soccer-2.22507.gme pes2.srm
|
||||
target/release/japs1me import mysaves.srm save-games/pro-evolution-soccer-2.22507.gme BESLES-03946PES-OPT
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- Accepts `.gme` files and raw images (`.srm`, `.mcr`, …) detected by size and `MC` signature.
|
||||
|
|
@ -89,9 +82,25 @@ target/release/japs1me import mysaves.srm save-games/pro-evolution-soccer-2.2250
|
|||
|
||||
- Back up saves before converting.
|
||||
- `convert` refuses to overwrite; delete or rename a previous `.srm` first if you intend to replace it.
|
||||
- `import` replaces the target `.srm` after staging and validation; back it up first and keep RetroArch closed while modifying it.
|
||||
- `import` and `delete` replace the target `.srm` after staging and validation; back it up first and keep RetroArch closed while modifying it.
|
||||
- `install` backs up the overwritten card automatically, but keep an independent backup of anything irreplaceable.
|
||||
- Avoid testing against your only copy of a save; the fixture in `save-games/` is read-only test input.
|
||||
|
||||
## Design compared with JAPS2ME
|
||||
|
||||
JAPS1ME's CLI mirrors JAPS2ME, but the workflow differs because the emulators
|
||||
manage cards differently:
|
||||
|
||||
- PCSX2 and its derivatives share one memory card across many games, so
|
||||
JAPS2ME trades in single-save containers (`.cbs`/`.max`) imported into a
|
||||
shared card.
|
||||
- RetroArch and PS1 emulators like PCSXR instead use one memory card per
|
||||
game, with the `.srm` basename matching the disc image. Whole-card
|
||||
`convert` and `install` are therefore the primary workflow here.
|
||||
- Importing individual saves out of a shared card image only makes sense from
|
||||
`.gme` DexDrive archives, so `import` is limited to `.gme` sources; there is
|
||||
no single-save (`.mcs`/`.psx`) support.
|
||||
|
||||
## Scope compared with MemcardRex
|
||||
|
||||
JAPS1ME focuses on `.gme` → `.srm` conversion, save listing, and save
|
||||
|
|
@ -100,7 +109,7 @@ importing rather than general memory-card editing:
|
|||
- `list` covers saves and free slots; there is no per-frame browser.
|
||||
- `convert` handles DexDrive `.gme` only; there is no VGS/VMP/MCX support and no reverse conversion.
|
||||
- `import` copies whole saves from `.gme` into `.srm`; there is no single-save (`.mcs`/`.psx`) support and no import into `.gme`.
|
||||
- There is no GUI, save import/export of single saves (`.mcs`/`.psx`), deletion, formatting, comment editing, or hardware (DexDrive/serial) support. JAPS1ME validates directory checksums read-only and never recalculates them.
|
||||
- There is no GUI, card formatting, comment editing, or hardware (DexDrive/serial) support. JAPS1ME validates directory checksums read-only and never recalculates them, except when relinking frames during imports and resetting them during deletions.
|
||||
|
||||
For details about the card formats, see the [technical format guide](docs/FORMATS.md). The [save-games collection](save-games/README.md) lists the saves shared in this repository.
|
||||
|
||||
|
|
|
|||
|
|
@ -5,9 +5,9 @@ Files remain in their original DexDrive `.gme` container format.
|
|||
|
||||
## Collection
|
||||
|
||||
| File | Format |
|
||||
| --- | --- |
|
||||
| `pro-evolution-soccer-2.22507.gme` | DexDrive (`.gme`) — Pro Evolution Soccer 2 (2 saves: `BESLES-03946PES-OPT`, `BESLES-03946PES-D2A`) |
|
||||
| File | Format | Origin |
|
||||
| --- | --- | --- |
|
||||
| `pro-evolution-soccer-2.22507.gme` | DexDrive (`.gme`) — Pro Evolution Soccer 2 (2 saves: `BESLES-03946PES-OPT`, `BESLES-03946PES-D2A`) | [Toukichi1 on GameFAQs](https://gamefaqs.gamespot.com/ps/582940-pro-evolution-soccer-2/saves) |
|
||||
|
||||
## Using a save
|
||||
|
||||
|
|
@ -29,6 +29,7 @@ created or have permission to redistribute. Do not include personal
|
|||
information or credentials in save data.
|
||||
|
||||
The JAPS1ME project is GPL-3.0-or-later, but that license does **not**
|
||||
automatically apply to save files in this directory. No separate license or
|
||||
automatically apply to save files in this directory. **These saves are offered completely "as is" with no guarantee of a license or validity.** No separate license or
|
||||
redistribution rights are implied for an individual save; retain any
|
||||
attribution, terms, and permissions that apply to its source.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
//! JAPS1ME - PS1 RetroArch Save Converter
|
||||
//! JAPS1ME - Just A PS1 Memory Card Editor
|
||||
//!
|
||||
//! A library for reading DexDrive (`.gme`) and raw (`.srm`/`.mcr`) PlayStation 1
|
||||
//! memory-card images, with support for converting `.gme` files to RetroArch
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ use std::path::{Path, PathBuf};
|
|||
#[command(
|
||||
name = "japs1me",
|
||||
version,
|
||||
about = "JAPS1ME - PS1 RetroArch Save Converter (DexDrive .gme to RetroArch .srm)"
|
||||
about = "JAPS1ME - Just A PS1 Memory Card Editor (DexDrive .gme to RetroArch .srm)"
|
||||
)]
|
||||
struct Cli {
|
||||
#[command(subcommand)]
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue