bms-diff-install

What problem does it solve?

It removes the tedious manual work of installing BMS chart differentials from a beatoraja-compatible difficulty table by automatically downloading, matching parent songs, and placing the resulting chart files into the correct music folders.

Core Features & Use Cases

• Difficulty-table-driven batch install: Reads a difficulty table header.json, processes each entry, downloads url_diff, extracts chart and related assets, and places charts into matched parent folders without overwriting existing files.
• Parent-song auto-install (optional): When a differential references a parent that is not installed, it can resolve parent URLs via host adapters (manbow/venue.bmssearch/GDrive/Dropbox/archive.org) and download and install the parent songs too.
• Disambiguation with Haiku subagent: Uses deterministic scoring for clear matches and delegates ambiguous cases to a Haiku subagent to decide the correct parent folder.
• Optional songdata.db registration: After placement, can run the built-in songdb pipeline to insert fully populated rows into beatoraja’s songdata.db so charts appear without an expensive full rescan.

Quick Start

Ask the skill to install charts by providing the difficulty table header.json URL, the beatoraja songdata.db path, your music root folder path, and a writable state directory, then run the skill to complete dry-run, parent installation (if needed), placement, and reporting.