https://github.com/jonthysell/romsift
Utility for sifting through large ROM collections.
https://github.com/jonthysell/romsift
Last synced: about 1 month ago
JSON representation
Utility for sifting through large ROM collections.
- Host: GitHub
- URL: https://github.com/jonthysell/romsift
- Owner: jonthysell
- License: mit
- Created: 2020-03-29T21:34:17.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2022-01-21T19:18:09.000Z (over 4 years ago)
- Last Synced: 2025-02-16T18:17:35.496Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 31.3 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# romsift #
romsift is utility for sifting through large ROM collections.
It is intended to help pare down large romsets (particularly [no-intro](https://www.no-intro.org/)) to remove unwanted duplicates and make browsing the files easier.
It works by scanning a directory of files and grouping them by their title, ignoring any tags (text in parentheses).
With the `sift` command, you can delete duplicate files for a title. You choose which file(s) you wish to keep, and let romsift delete the others.
With the `clean` command, you can rename files to remove the tags. romsift will only remove the tags that every title has in common, leaving the unique tags. For example, cleaning the following:
```
Popular Game (USA).zip
Popular Game (USA) (Beta).zip
```
will become:
```
Popular Game.zip
Popular Game (Beta).zip
```
because every file for `Popular Game` has the `USA` tag.
However, cleaning:
```
Popular Game (Japan).zip
Popular Game (USA).zip
Popular Game (USA) (Beta).zip
```
results in no changes:
```
Popular Game (Japan).zip
Popular Game (USA).zip
Popular Game (USA) (Beta).zip
```
because each tag is still necessary to differentiate the files.
## Usage ##
```
Usage: romsift command [options]
Utility for sifting through large ROM collections.
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
sift [options] sift through files to remove duplicates
clean [options] remove unecessary tags from file names
help [command] display help for command
```
```
Usage: romsift sift [options]
sift through files to remove duplicates
Options:
-i, --interactive prompt the user for which files to sift (default: false)
-n, --noop only preview file changes, don't actually sift (default: false)
-v, --verbose show verbose output (default: false)
-h, --help display help for command
```
```
Usage: romsift clean [options]
remove unecessary tags from file names
Options:
-i, --interactive prompt the user for which files to clean (default: false)
-n, --noop only preview file changes, don't actually clean (default: false)
-v, --verbose show verbose output (default: false)
-h, --help display help for command
```
## Errata ##
romsift is open-source under the MIT license.
Copyright (c) 2020-2022 Jon Thysell