Clone Hero-friendly Organized Repository of User-provided Songs
The current state of Guitar Hero/Rock Band/Clone Hero custom songs aggregation is rather unsatisfying, scattered and newcomer-averse: this is an attempt to make it more searchable and user-friendly.
The current sources are based on the official CH charts spreadsheet with a ton of songs from talented charters, including conversions from C3, as well as the official GH/RB setlists. There are currently more than 20,000 charts indexed, and the number is still growing!
Disclaimer: I am not responsible of the charts and songs that are indexed by chorus (except the charts that are attributed to "Paturages"). If you have an issue with any of those, please contact the charters and/or the source owners (links to sources are provided for every song).
chorus periodically imports links to songs from a list of mostly Google Drive folders (manually provided in the sources folder). It crawls the provided folders, downloads the .chart
/.mid
and song.ini
files (or entire archives) to parse them for information, formally saves the links (not the song bundles themselves) and their metadata in a database and discards the downloaded items. The web app simply reads and searches from the data that is saved in the database.
The search engine makes use of PostgreSQL's ts_vectors
and trigrams (via the pg_trgm
extension): it operates on the concatenation of artist/band, song, charter and source names. It seems to be working pretty well for now!
Follow the instructions described here.
(This might or might not work on Windows. Please reach out to me if you encounter problems.)
Configure a PostgreSQL database and get your Google API client ID and secret. Copy the conf.example folder to a conf folder and fill in the credential files.
npm install
the node dependencies. npm run import
to fill your database with all the drives. npm start
to start the dev server for the web app.
npm run import <short_name>
to run just one particular import script.
Fair warning: the very first run will take more than 12 hours, so make sure to run the script as a background task. The following runs should only take about an hour, depending on the amount of new charts. If you're not willing to go through the 12+ hours, feel free to ask me for a database dump on Discord (Paturages#9405
) or elsewhere.
(you can definitely help if you want to!)