mirror of
https://gitea.tendokyu.moe/beerpsi/fsdecrypt.git
synced 2026-10-09 07:00:00 +03:00
JujuforceandClaude Opus 4.8
d92e4b5ba9
- Unit tests for calculate_page_iv (incl. 8-byte wrap), calculate_file_iv round-trip, and game-key lookup - Extract exfat_utc_offset_seconds and nt_timestamp_to_system_time as pure helpers and test them (covers the recent exFAT UtcOffset fix) - scripts/test.sh runs cargo test + a smoke test natively, then repeats for the x86_64-musl target in a clux/muslrust container (no hosted CI needed) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
78 lines
2.1 KiB
Markdown
78 lines
2.1 KiB
Markdown
# fsdecrypt
|
|
|
|
Decryptor and extractor for SEGA arcade filesystem containers (fscrypt format). Works on Windows and Linux, no admin privileges required.
|
|
|
|
## Installation
|
|
|
|
Requires [Rust](https://www.rust-lang.org/tools/install).
|
|
|
|
```bash
|
|
cargo build --release
|
|
```
|
|
|
|
The binary will be at `target/release/fsdecrypt` (or `fsdecrypt.exe` on Windows).
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
fsdecrypt <FILES>...
|
|
```
|
|
|
|
### Examples
|
|
|
|
```bash
|
|
# Extract a game APP container
|
|
fsdecrypt ABCD_1.00.00_20240101120000_0.app
|
|
|
|
# Extract an OPTION/DLC container
|
|
fsdecrypt ABCD_A001_20240101120000_0.opt
|
|
|
|
# Extract multiple files at once
|
|
fsdecrypt game_v1.app game_v2.app extras.opt
|
|
|
|
# Decrypt only (outputs raw .ntfs/.exfat image, no extraction)
|
|
fsdecrypt --no-extract ABCD_1.00.00_20240101120000_0.app
|
|
```
|
|
|
|
### Delta Updates
|
|
|
|
Games often ship incremental updates as a separate `.app` file. Just pass the update file — fsdecrypt will automatically find the base in the same folder and merge them:
|
|
|
|
```bash
|
|
fsdecrypt ABCD_1.01.00_20240215143000_1_1.00.00.app
|
|
```
|
|
|
|
You can also pass both explicitly:
|
|
|
|
```bash
|
|
fsdecrypt ABCD_1.00.00_20240101120000_0.app ABCD_1.01.00_20240215143000_1_1.00.00.app
|
|
```
|
|
|
|
The output folder is named after the input file (e.g. `ABCD_1.01.00_20240215143000_1_1.00.00/`).
|
|
|
|
## External Key Files
|
|
|
|
For games not in the built-in key database, place a file named `{GAME_ID}.bin` in the working directory:
|
|
|
|
- **16 bytes** for key only (IV derived automatically)
|
|
- **32 bytes** for key + IV
|
|
|
|
## Testing
|
|
|
|
Tests run locally (there is no hosted CI). The unit tests are plain `cargo test`;
|
|
the Linux `x86_64-musl` release target is exercised via Docker when you need it.
|
|
|
|
```bash
|
|
cargo test # unit tests (IV derivation, timestamp decoding, key lookup)
|
|
scripts/test.sh # native tests + smoke test, then the same in a musl container
|
|
scripts/test.sh --no-docker # skip the Docker/Linux step
|
|
```
|
|
|
|
`scripts/test.sh` uses the [`clux/muslrust`](https://hub.docker.com/r/clux/muslrust)
|
|
image to build and test the static Linux binary — the same way release artifacts
|
|
are produced — so both targets can be validated from any host.
|
|
|
|
## License
|
|
|
|
[BSD Zero Clause License](LICENSE) (0BSD)
|