/nacreous

Downloads and tags tracks from Soundcloud.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

nacreous

nacreous is an overkill Python 3.5 utility that downloads tracks from Soundcloud, tags them, and embeds cover art.

https://upload.wikimedia.org/wikipedia/commons/c/cc/Nacreous_clouds_Antarctica.jpg

nacreous uses Selenium to fetch track URLs, and youtube-dl to download them. You might be befuddled about the choice of dependencies, but they are the product of frustration with other sync scripts using the Soundcloud API and incompletely syncing, failing to download certain tracks, or not tagging effectively or embedding cover art.

Requirements

At this time there is no one-click install or py2exe binaries for every platform. As such, brave users are required to install the following dependencies:

  • Python 3.5 (3.4 and below are not supported)
  • Firefox, because it's the simplest Selenium WebDriver backend to install across all platforms.

Installation

$ pip install -r requirements.txt
$ python setup.py install
$ nacreous --help

Basic Usage

Currently, the only support sub-command is sync. The following command will download all of the given user's likes:

nacreous sync --likes impendingdave

Alternatives

There are quite a few Soundcloud sync tools/scripts out there if nacreous doesn't fit the bill for you.