soundbasin

1.0.0 • Public • Published

SoundBasin

Download & auto-sort your liked tracks on SoundCloud, with MP3 meta-tagging (meta-tags Windows only).

Requirements & Installation

This is a Node.js application and depends on the following modules:

colors
follow-redirects
soundcloud-mp3
mkdirp
multiline

If you download SoundBasin via NPM these will all be installed for you, so no worries.

npm install soundbasin

The MP3 tagging requires Windows to work, the CLI software it uses id3.exe is abandonware and its licensing information and source is archived.

Config & Usage

Once installed you'll have to configure the settings slightly. Edit config.json.

{
    "rssLink": "http://feeds.soundcloud.com/users/soundcloud:users:XXXXXXXX/sounds.rss",

    "staggerDelay": 3000,
    "id3ify": true
}

rssLink

This is a RSS link unique to your profile & can be found within your SoundCloud Settings at https://soundcloud.com/settings/content

staggerDelay

How many miliseconds between each song lookup? Recommended setting is 3000.

id3ify

Only set this as true if you're on Windows, it kicks the usage of id3.exe into life.

Get it going

Navigate your Command Line program to the app location & simply fire the command below.

node index

Where the Mp3s are saved

All the songs and tracks are sorted into their respective artist folders within the app's downloads/ directory.

Limitations

  • There is currently only a CLI interface.
  • MP3 meta-tags are only availaible on Windows.
  • MP3 meta-tags are limited to & cut off at 30 characters in length (limitation of id3.exe)

Readme

Keywords

Package Sidebar

Install

npm i soundbasin

Weekly Downloads

1

Version

1.0.0

License

MIT

Last publish

Collaborators

  • bogstandard