Hi everyone,
I forked KHIDL https://github.com/qwerinope/khidl and turned it into a tool focused on LaunchBox users.
The goal is simple: automatically download one high-quality soundtrack theme for every game in your LaunchBox library.
Features
Reads games directly from LaunchBox XML files (Data/Platforms)
Processes a single platform or your entire LaunchBox library
Automatically searches KHInsider for matching soundtracks
Intelligent album selection using a scoring engine
Prefers:
Gamerips
Official Soundtracks
Original Soundtracks
Penalizes:
Remix albums
Piano collections
Arrange albums
Cover albums
Lost Tracks
Bonus discs
Fan albums
Platform-aware matching (N64 games prefer N64 albums, etc.)
Uses release year to avoid incorrect matches
Fuzzy title matching with multiple search strategies
Duplicate detection
Intelligent theme selection
Main Theme
Title Theme
Opening
Intro
Menu
Skips tracks shorter than 30 seconds
Downloads MP3, FLAC, or automatically selects the best available format
Embeds the KHInsider album cover into every downloaded audio file
Caching for much faster future runs
Skips games that already have music
Fully configurable scoring via scoring.yaml
GitHub
https://github.com/agzina0sicim/khidl-lb
AI Disclosure
This project was developed with significant AI assistance. AI was used throughout the implementation, refactoring, documentation, and feature development process.
