lsdj-tools

LittleSoundDj, or LSDJ for short, is popular music tracker software for the original Nintendo Game Boy. While the handheld console originally was released in 1989, (chiptune) musicians still use its hardware to create and perform electronic music nowadays.

While LSDJ has a built-in filesystem for managing tracks, you need tools to get out the individual files for back-ups or constructing new save files from exported tracks. This crate provides a command-line utility that does exactly that.

Inspect

Inspect LSDJ .sav and .lsdsng files, or even entire directories for their contents

```console USAGE: lsdj-tools inspect [OPTIONS] [PATH]...

ARGS: ... The path(s) to inspect

OPTIONS: -h, --help Print help information -r, --recursive Search the folder recursively -V, --version Print version information ```

Example

console 4ntler@mbp > lsdj-tools inspect bangers.sav Mem 144/192 [================== ] 0 | YOKAI | v027 | f005 1 | ASPHALT | v019 | f005 2 | NEWSHOES | v014 | f005 3 | FUNGAL | v019 | f005 4 | LOGCBN | v015 | f005 5 | NOSTALGA | v031 | f005 6 | GJITSU | v026 | f005 7 | PRISTINE | v016 | f005 8 | KALEIDO | v024 | f005 9 | CACTUAR | v046 | f005 10 | DODGBALL | v018 | f005 11 | DNTSWEAT | v025 | f005 12 | HONEY | v031 | f005

Export

Export .lsdsng's from .sav files

```console USAGE: lsdj-tools export [OPTIONS] [INDEX]...

ARGS: The path to the save file to export from ... Indices of the songs that should be exported. No indices means all songs

OPTIONS: -d, --decimal Use decimal version numbers, instead of hexadecimal -h, --help Print help information -o, --output

The destination folder to place the songs -p, --output-pos Prepend the song position to the start of the filename -v, --output-version Append the song version to the end of the filename -V, --version Print version information ```

Example

console 4ntler@mbp > lsdj-tools export -pv bangers.sav 00. YOKAI => 00_YOKAI_v1B.lsdsng 01. ASPHALT => 01_ASPHALT_v13.lsdsng 02. NEWSHOES => 02_NEWSHOES_v0E.lsdsng 03. FUNGAL => 03_FUNGAL_v13.lsdsng 04. LOGCBN => 04_LOGCBN_v0F.lsdsng 05. NOSTALGA => 05_NOSTALGA_v1F.lsdsng 06. GJITSU => 06_GJITSU_v1A.lsdsng 07. PRISTINE => 07_PRISTINE_v10.lsdsng 08. KALEIDO => 08_KALEIDO_v18.lsdsng 09. CACTUAR => 09_CACTUAR_v2E.lsdsng 10. DODGBALL => 10_DODGBALL_v12.lsdsng 11. DNTSWEAT => 11_DNTSWEAT_v19.lsdsng 12. HONEY => 12_HONEY_v1F.lsdsng

Import

Import .lsdsng's into a .sav file

```console USAGE: lsdj-tools import --output

[SONG]...

ARGS: ... Paths to the songs that should be imported into a save

OPTIONS: -h, --help Print help information -o, --output

The output path -V, --version Print version information ```

Example

console 4ntler@mbp > lsdj-tools import banger1.lsdsng banger2.lsdsng -o ./test.sav 00 => banger1.lsdsng 01 => banger2.lsdsng Wrote test.sav

Support

If you like this crate and want to support me somehow, consider buying some of my music.