Skip to content

A script to organize CD-ROM images for an optical drive emulator

Notifications You must be signed in to change notification settings

famicomical/spellsort

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 

Repository files navigation

SpellSort

A script that will organize your disc images and prepare them for use with an Optical Drive Emulator (ODE). Namely, SpellSort was designed for the Wizard and DocBrown ODE's for the FM-Towns Computers and the FM-Towns Marty console.

Wizard & DocBrown devices require adherence to a strict folder structure on the SD card to work properly. The user must manually rename directories and write 'titles' for their games to be displayed on the ODE's boot menu. SpellSort was made to simplify game library maintenance for ODE users. Just drop your disc image files on the SD card any way you like and run SpellSort to ready your device.

Usage

You need to have Python 3 installed on your OS.

Extract the contents of this repo to the root of your Wizard/DocBrown SD card. Make sure you have either the "Wizard Spellbook" or "Marty's Almanac" in the '01' folder of your SD card already.

python spellsort.py --help

will display your options for using the script.

usage: spellsort.py [-h] [--retitle] [--cleanup] [--compile]

SpellSort program for Wizard/DocBrown CD drive emulators.

optional arguments:
  -h, --help  show this help message and exit
  --retitle   will force title.txt generation for all folders
  --cleanup   moves all non-numeric files and folders to 'ignore' folder, does
              nothing else
  --compile   executes RunMe.bat in folder '01' after terminating

Details

Disc image files associated with each other are assumed to have the same base name.

e.g.:

Pu-Li-Ru-La (Japan).ccd
Pu-Li-Ru-La (Japan).img
Pu-Li-Ru-La (Japan).sub

constitute a valid set. SpellSort will not attempt to search for associated disc image files that don't have the same name.

Only sorting by alpha is supported. Customizable file order would work best with a GUI, which is beyond the scope and intent of this project.

Disc images must be uncompressed. SpellSort will not automatically decompress zip/rar/etc archives.

Warning: SpellSort will move all of the files on your SD card. If you are using your ODE's SD card as general storage, you can place your files in a folder called "ignore" at the root of the SD. This is the only folder whose contents will remain unchanged on a normal run.

On a cleanup run, files that aren't used by Wizard will be moved to the 'ignore' folder.

About

A script to organize CD-ROM images for an optical drive emulator

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages