taotao54321 / fcdstools

Famicom Disk System disk image manipulation

fcdstools

Famicom Disk System disk image manipulation tools.

fdscheck can recognize game titles with the internal database. This database is converted from FDS Study database, and it is originally developed by ena and gponys. Thanks for the great work and the permission to use!

Usage

check:

$ fdscheck game.fds                 # with internal database
$ fdscheck --db fdsdb.json game.fds # with custom database
$ fdscheck --nodb game.fds          # without database

split:

$ fdssplit game.fds

build:

$ fdscheck -f manifest game.fds > manifest.json
$ fdssplit game.fds
... (modify files)
$ fdsbuild out.fds manifest.json

convert FDS Study database into JSON:

$ fdssjson fdsdb-be.txt > fdsdb.json

To convert Japanese database, encoding conversion is needed:

$ iconv -f cp932 -t utf-8 fdsdb-bj.txt > fdsdb-bj-utf8.txt
$ fdssjson fdsdb-bj-utf8.txt > fdsdb-ja.json

Install

$ pip install fcdstools

Dependency

• Python >= 3.6
• setuptools
• kaitaistruct
• tabulate

To compile *.ksy files by yourself, HEAD of kaitai-struct-compiler is required.

Resources

• nesdev wiki
• gponys' FDS resources
• Enri's FDS page

Credits

• ena developed FDS Study.
• gponys is maintaining FDS Study unofficial database.