dnsgeek/d64-cataloger

D64Catalog is a tool for people who have large collections of old Commodore computer disk, tape, and cartridge image files and need a way to actually find things inside them. The README puts it plainly: if you have tens of thousands of disk images and can only half remember which one holds a particular program from decades ago, this is built to solve that. The core is a Python script that walks through a folder of these old image files, reads each one's internal directory listing, and stores every file's details in a searchable database. It supports many classic Commodore formats, including disk images like D64, D71, D80, D81, and D82, tape images like T64 and TAP, single program files, and cartridge images. For each entry it records details such as the original file name, the type of file, its size, and where it is physically located on the original media. Once a collection has been scanned, you can search across everything using simple command line queries, including exact phrases, wildcard prefixes, and boolean combinations like matching one term while excluding another. Rescans are efficient: files that have not changed are skipped automatically unless you force a full rescan. For people who prefer a visual interface instead of the command line, there is an optional graphical front end written in a language called PureBasic, which needs to be compiled separately but then works on Windows, Linux, and macOS. It lets you pick a folder, start a scan with a progress display, and search with filters for specific formats. The tool is careful about the messiness of real world old files, including tapes with known broken headers and corrupted or truncated images, skipping problems with a warning rather than stopping the whole scan. It requires only Python's standard library to run, with no extra packages needed. The project is released under the GPLv2 license.