dldldl v1.0.2

dldldl

dldldl is a simple node utility for incrementally syncing your music playlists on various sites onto your hard drive. Currently it supports YouTube and Soundcloud.

Usage

Start with dldldl <library path>.

Configuration

Pick a folder for storing the music library.

A config JSON file is required into the libary folder, called <library path>/dldldl.json.

The config JSON file should have a "playlists" field with the playlist names and URLs listed as key-value pairs.

The playlist names are arbitrary, and are also used as folder names for downloading music.

Example:

  {
    "playlists": {
      "MyPlaylistName1": "https://youtube.com/playlist?list=<playlist id>",
      "MyPlaylistName2": "https://soundcloud.com/user/<user>/sets/<playlist name>"
    }
  }

This will result in the following folder structure:

  <libarary path>/MyPlaylistName1/...
  <libarary path>/MyPlaylistName2/...

Music library

The tracks are downloaded into separate folders, as seen above. The tracks are identified by their filenames. Renaming the files will result in downloading them again.

The filename based identification has some advantages. For scanning a music library we only have to read file paths, which is very fast. No DB is built from file metadata, etc.

The folder structure can be modified freely, so you can organize the tracks however you want. New tracks will always be downloaded into the playlist's original folders.

Spotify

Supporting Spotify is a non-goal because AFAIK there are no libraries to extract music from it. The working solutions are very hacky, e.g. one application I saw started an actual Spotify client to do the job.

Similar software

• AllToMP3 is a desktop app for downloading playlists.
• youtube-dl is a command line application for downloading videos from Youtube. The project also provides the fine https://www.npmjs.com/package/ytdl-core library, which is also used in this project.
• https://pypi.org/project/soundcloud-dl/ is a Python program for getting Soundcloud playlists.