Romlister

if args.extensions: lister.filter_by_extension(args.extensions) if args.min_size is not None or args.max_size is not None: lister.filter_by_size(args.min_size, args.max_size) if args.pattern: lister.filter_by_name_pattern(args.pattern)

class RomLister: def (self, root_path, recursive=True): self.root_path = Path(root_path) self.recursive = recursive self.roms = [] romlister

if args.list_only or not args.output: for rom in lister.get_list(clean_names=args.clean_names): print(rom) else: if args.format == "txt": lister.export_txt(args.output, clean_names=args.clean_names) elif args.format == "csv": lister.export_csv(args.output, clean_names=args.clean_names) elif args.format == "json": lister.export_json(args.output, clean_names=args.clean_names) print(f"Exported to args.output") if == " main ": main() 🧪 Usage Examples # List all NES ROMs in folder python romlister.py ~/roms/nes -e nes -r List SNES ROMs larger than 1 MB, output as JSON python romlister.py ~/roms/snes -e sfc -r --min-size 1048576 -f json -o snes_large.json Find ROMs with "Mario" in name, clean tags, print to console python romlister.py ~/roms -r -p "Mario" --clean-names --list-only Export all .iso/.bin files recursively to CSV python romlister.py ~/roms/psx -e iso bin -r -f csv -o psx_roms.csv 🔧 Possible Extensions (if you want to expand) | Feature | Description | |--------|-------------| | ROM metadata | Read headers (e.g., iNES for NES) to show game title, mapper, etc. | | CRC/SHA verification | Compare against No-Intro/Redump DAT files | | Duplicate finder | Group by size/hash to find duplicates | | Web UI | Expose as a Flask app with live filtering | | Launch integration | Launch selected ROM with emulator | ✅ Sample Output Super Mario Bros Legend of Zelda Metroid Contra or as JSON: if args

def export_txt(self, filepath, clean_names=False): with open(filepath, 'w', encoding='utf-8') as f: for item in self.get_list(clean_names): f.write(item + '\n') clean_names=False): with open(filepath

args = parser.parse_args()

[ "/home/user/roms/nes/Super Mario Bros (USA).nes", "/home/user/roms/nes/Legend of Zelda (USA).nes" ]