Repository navigation
SpinDoctor v2.4.1
Windows binaries
Built with Python 3.8.10 + PyInstaller 5.13.2 on windows-2022. Runs on Windows 7 SP1 and newer.
Drop the .exe files into a folder on PATH (or call by full path). No Python install required on the cabinet. See docs/installation.md for the full walkthrough.
What's in spindoctor-windows-v2.4.1.zip:
spindoctor.exe— full CLIspindoctor-gui.exe— double-clickable GUI launcher (no cmd.exe required)spindoctor-fav.exe— Favorites wheel managerspindoctor-recent.exe— Recently Played rebuildspindoctor-stats.exe— playtime reports + Most Played wheel
Verify your download:
SHA256SUMS.txt— verify withsha256sum -c SHA256SUMS.txt.- Build provenance:
gh attestation verify spindoctor-windows-v2.4.1.zip --repo phillram/spindoctorproves the zip came from this workflow.
Fixed
-
Archive-packed media files were silently skipped during Favorites / Recently Played / Most Played wheel rebuilds. HyperSpin reads
.zip-packed media natively, so source systems commonly store artwork as.ziparchives rather than raw.mp4/.pngfiles. Downloaded media packs may also use.rar,.7z,.lha,.lzh,.gz, or.tar. The_FILE_EXTSallowlist inmedialink.pycontained none of these, so they were never copied toMedia/Favorites/etc., leaving the synthetic wheel with no video or background art even though the games displayed correctly in their source system's wheel. All seven archive extensions (.zip,.rar,.7z,.lha,.lzh,.gz,.tar) are now included. -
Running
fav rebuild --apply,recent rebuild --apply, orstats build-wheel --applyfor the first time did not create<hyperspin_dir>/Settings/<system>.ini. HyperSpin requires this file to open a sub-wheel; without it the frontend shows "Cannot find Recently Played.ini" (or "Favorites.ini" / "Most Played.ini") when the wheel is selected from the main menu, so the wheel never loads. SpinDoctor was already writing the RocketLauncher settings (Settings/<system>/Emulators.ini) but not the HyperSpin-side settings. Each rebuild command now writes a minimalSettings/<system>.inicontaining[exe info]\nhyperlaunch=truewhen the file does not exist — existing files (created by HyperHQ or the user) are never overwritten. -
generate-configwas blind to folder-layout cabinets (where RocketLauncher usesSettings\<system>\Emulators.iniinstead ofSettings\<system>.ini). On these cabinets — which are produced by HyperHQ and are common in the wild —generate-configwould always report "(new file)" in its dry-run and write a flatSettings\<system>.inithat RL may not read, leaving theEmulators.iniwith a staleRom_Path. The command now detects which layout each system uses and writes to the matching file: folder-layout systems get theirEmulators.iniupdated (using the[ROMS]section that RL requires for this layout); flat-layout systems get their.iniupdated as before; systems with neither file get both written so the cabinet works regardless of layout. The dry-run table also now shows the correct currentRom_Pathread from whichever file actually exists. -
Settings/<system>/Emulators.ini(folder-layout) included a[PCLauncher]section that caused RocketLauncher to blank outRom_Extension. On first launch after a wheel rebuild, RL's own AHKIniWritefilled in the[PCLauncher]section with empty values includingRom_Extension=. On the next launch RL readRom_Extensionfrom[PCLauncher], found the blank value, and fell back to the global extension list (zip|rar|7z|…), producing "Cannot find Rom 1942 with any provided Rom_Extension: zip|rar|7z|lha|lzh|gzip|tar|" even after a successful rebuild. The working HyperHQ-generatedEmulators.ini(confirmed on the same cabinet) contains only[ROMS]. The folder-layoutEmulators.ininow writes only[ROMS]; the flatSettings/<system>.iniretains its[PCLauncher]block because the flat layout does not trigger RL's write-back. -
"Schedule auto-refresh" and "Preflight" showed routine-outcome popup dialogs instead of routing their result to the Output panel like every other action in the GUI.
_schedule_autorefreshcalledmessagebox.showinfoafter already writing the full task detail to the Output panel — the popup was redundant and interrupted keyboard flow._summarise_preflightsimilarly raised a "Preflight passed" dialog when the Output panel banner and status bar already conveyed the result. Both popups have been removed;_schedule_autorefreshnow includes the bat path and reboot hint in_append_outputand calls_flash_statusfor inline acknowledgement. -
"Restore RocketLauncher INI from backup" (Meta tab) was hardcoded to the flat-layout path
Settings/<system>.iniand silently failed on HyperHQ cabinets that use the folder layout (Settings/<system>/Emulators.ini). The button now checks for the folder-layout file first and falls back to the flat-layout path, matching the detection order used by the rest of SpinDoctor.
What's Changed
- fix: meta-restore-rl-ini detects folder-layout Emulators.ini by @phillram in #182
- fix: generate-config detects and updates folder-layout Emulators.ini by @phillram in #181
- fix: remove routine-outcome popups (scheduled task, preflight) by @phillram in #183
- fix: remove [PCLauncher] section from folder-layout Emulators.ini by @phillram in #184
- fix: copy zip-packed media; write HyperSpin Settings INI for synthetic wheels by @phillram in #185
- chore: bump version to 2.4.1 by @phillram in #186
Full Changelog: v2.4.0...v2.4.1