retro-sort sorts your files into a folder structure suitable for use with retro hardware
Use homebrew:
brew install stilvoid/tools/retro-sort
OR
Download a binary for your OS from the releases page.
OR
Build retro-sort with go:
go install github.com/stilvoid/retro-sort/cmd/retro-sort@latest
retro-sort [src] [dst] [flags]
-n, --dry-run Dry run. Print the file names and exit
-g, --glob string Only include files matching this glob (default "*")
-h, --help help for retro-sort
-q, --quiet Don't print anything, just do it
-s, --size int Maximum number of directory entries (default 100)
--tosec Experimental: Detect TOSEC filenames and group related files
-u, --upper Make upper-case directory names
retro-sort scans src for files (optionally matching the glob provided in the --glob flag).
It then determines an appropriate folder structure where no folder contains more than size files.
Finally, retro-sort copies all of the files to their new locations (unless you specify --dry-run).
retro-sort will exit with an error if dst already exists.
If you want to merge the files output from retro-sort, use a new folder first and then copy/move everything after.
For aesthetic reasons, you can specify --upper to have retro-sort create all the directory names in upper-case.
To give you an idea, here's a silly and trivial example. Imagine you have a folder of disk images that looks like this:
disks/
aargh.disk
addams_family.disk
chaos_engine.disk
elite.disk
elite_ii.disk
exolon.disk
And you are working with some retro hardware that simply can't cope if a folder contains any more than 2 files.
If you run retro-sort -s 2 disks out, then retro-sort will create the following directory structure:
dists/
a/
aargh.disk
addams_family.disk
c/
chaos_engine.disk
e/
el/
elite.disk
elite_ii.disk
ex/
exolon.disk
If you picked a more generous size, retro-sort would make different decisions and consolidate where possible:
e.g. retro-sort -s 4 disks out would create this structure:
dists/
a-c/
aargh.disk
addams_family.disk
chaos_engine.disk
e/
elite.disk
elite_ii.disk
exolon.disk
retro-sort includes a --tosec flag that, if enabled, will check if file names match the TOSEC naming convention
and if so, group files related to a title into the same folder. This can save a lot of space in directories that
would otherwise contain a lot of files starting with the same letter (for example, there are hundreds of variations
of Jet Set Willy for the Spectrum).
This flag is experimental for now but will likely become default before v1.0.