• Python (3.10.6 tested, other versions probably work just as fine)
• FFmpeg, installed and in system PATH

You can grab the requirements directly or, alternatively, through scoop/winget, which is preinstalled on windows 10 (1809 or later). If you choose to use scoop, follow this guide.

If you have already installed Python and FFmpeg skip to the setup

Download python 3.10.6 here and run the installer.

! Make sure to check the "Add to PATH" checkbox

Follow for example these instructions on how to set up FFmpeg on your system.

1. Download and extract the zip file
2. Go into the MSRD folder and execute the setup.bat file (or follow the contributing instructions 3 to 5)
3. Close the window

1. Run msrd.bat this will open a new console in which you can use the downloader.
2. To see the commands type python msrd.py --help and run it. This will show a small help menu.

Example commands are

• python msrd.py download 232244 953983 Download the song with the ID 232244 and 953983
• python msrd.py download 953986 --m4a Download the song with the ID 953986 as m4a
• python msrd.py convert -a --mp3 Convert songs to mp3.
• python msrd.py convert -a -d --m4a Convert songs (and re-download them if the cache has been cleared) to m4a.
• python msrd.py download -a -t 2 Download all songs with two threads.
• python msrd.py cache clear audio Clear/delete the audio files the program worked with (don't worry the finished songs will not be deleted).

If you have a slow drive or internet I recommend limiting the threads depending on your specs.

Downloading the entire Discography (as of 2024.09.12, 598 songs) at 55Mb/s with 16 threads took 58min.

Contributions and improvements are very welcome.

1. Fork the repo
2. Make sure you are on the dev branch git checkout dev
3. Create the virtual environment python -m venv venv
4. Activate it venv\Scripts\activate
5. Install the requirements pip install -r requirements.txt
6. Make your changes
7. Pull requests should as well be on a separate branch like dev

This project is not affiliated with Hypergryph, Studio Montagne, Yostar or Gryphline in any ways.