Skip to content

Latest commit

 

History

History
101 lines (55 loc) · 5.56 KB

README.md

File metadata and controls

101 lines (55 loc) · 5.56 KB

iDeemYouWorthy

The two purposes of this program:

  1. Check Spotify for changes to your playlists, downloading the new tracks.
  2. Add the local versions of your Spotify playlists to iTunes.

Ultimately, the goal is to have a script that you can have running in the background, keeping your iTunes library up-to-date with Spotify.

Using Spotify for your music is great because you can access it from anywhere, you don't have to worry about the local files, and it's super easy to use.

Storing music locally (like on iTunes) is great because there aren't any ongoing costs, it's more versatile, and you aren't reliant on a corporate entity.

So, this aims to combine the best of both worlds.

Usage

The program files can be found in the directory ideemyouworthy. main.py is the main script; run that. It's written for Python 3.

Installation/Operation

Download the .zip file in "Releases". Unzip it. Navigate to ideemyouworthy with a terminal and run main.py using one of the following commands. It will depend on how your Python environment is set up.

  • python main.py
  • python3 main.py
  • main.py

It should be pretty straightforward from there. Music will be downloaded into the Music directory, which will be at the same level as the ideemyouworthy folder containing the code. To keep your directory clean, you should keep the entire thing in a parent directory, for example: D:/Downloaded Music/ideemyouworthy.

You'll need to add your Spotify and deezer account information to the account_info.json file. This file will be generated upon the first execution of main.py. Once it's there, gather the information following the steps below and paste it in. To verify the .json file is still formatted correctly, you can use https://jsonlint.com.

You will be able to get the playlists from your Spotify account. You can also (or alternatively, on its own) specify playlists to track in the custom_playlists.json file. Once the file is generated after the first run, you can add URLs. The URL should be the key, and the string should be empty. Use https://jsonlint.com to verify it's formatted correctly.

You are not giving me your password! These tokens are used to avoid sharing your password. All of this data is stored locally in the account_info.json file, and is sent exclusively to Spotify and deezer. It is safe.

Account Info

Finding SPOTIFY_USERNAME
  1. Go to https://open.spotify.com/. Sign into your account.
  2. In the top right, click your display name, then Account.
  3. Your Username should be the first field on this page.
Finding SPOTIFY_CLIENT_ID
  1. Go to https://developer.spotify.com/dashboard/login. Sign into your account.
  2. Select CREATE AN APP.
  3. The App name and App description are irrelevant. Click CREATE when you're ready.
  4. Your Client ID will be near the top right, under the app name/description.
Finding SPOTIFY_CLIENT_SECRET
  1. In the same app you created above, click SHOW CLIENT SECRET.
  2. Your Client Secret will appear.
Finding DEEZER_ARL
  1. Follow the instructions here. When you are told to enter the ARL into Deezloader, skip that.
  2. You should have your ARL copied.

FAQ/Misc. Notes

Does this duplicate tracks if you have two playlists with the same track?

This doesn't download the same track twice. It keeps track of which tracks are in what playlist and where they're stored, so there is only one file for each track. Deezer automatically

I'm getting some stack overflow error!

This happens when you overload deemix, trying to download too many tracks at once. Currently, the best fix is to only download something like 500 tracks at a time. Use the custom playlist file to control which playlists are downloaded.

I'm having trouble with ________, what's going on?

Please let me know if you have trouble with anything! You can open a GitHub issue, or contact me through any listed method.

Misc. notes:

You cannot track two playlists that have the same name. I haven't tested it, but it would cause so many problems. It would have been very annoying for me to have built this program with that in mind. Why would you even have two playlists with the same name in the first place?

If you have local files in your Spotify playlist, they'll be printed to cache/problematic_tracks.txt. You can figure out what to do with them.

If a file's path size is over 260, it will be printed to cache/problematic_tracks.txt. It cannot be added to iTunes on Windows.

In order to speed up the program, the download state is not saved until the end. If the program crashes in the middle, then, there will be some problems. It'll probably keep crashing. Running it again might fix it, but if it doesn't, you'll need to delete the necessary playlist files in the playlists folder. If that still doesn't fix it, you'll also need to delete cache/track_master_list.json.

There's currently a bug where tracks downloaded from YouTube aren't added to iTunes on the first pass. I think it arises from FFMPEG not being done with its processing yet. They should be caught during iTunes re-syncing (assuming you specify you want it done).

Contact Information

Discord: TheKingElessar#3226

Reddit: /u/TheKingElessar

Email: [email protected]

Legality

What are they gonna do, stab me storm my Capitol?