Usage with the macOS Music App

streamrip was designed to be used seamlessly with the macOS Music app. Follow one of the guides below to get started.

Automatic Setup

1. You need to have used your local music library at least once. That is, you must have some audio file added to your library. Doing this creates the settings file that streamrip will read.

2. Run rip config --music-app. This will edit the config file with the proper settings. You're now good to go!

Manual Setup

To manually set it up, you need to find the Automatically Add to Music.localized folder inside the file given at Music.app -> Preferences -> Files -> Music Media folder location. Set the downloads folder to the path in the config file.

Next, enable conversion and set the codec to alac. If you want to save space, set sampling_rate to 48000. Finally, set keep_hires_cover to false.

Finally, set folder_format to "". This will make streamrip dump tracks into the Automatically Add... folder without creating new folders inside. Without this, a FileNotFoundError may be raised if the Music App deletes the folder after importing and a new track is moved to the now nonexistent folder.

Now, you can download anything and it will appear in your Library!