Skip to main content

Scrape an artist from SoundCloud

Project description

SoundScrape!

SoundScrape!

SoundScrape Build Status PyPI Python 2 Python 3

SoundScrape makes it super easy to download artists from SoundCloud (and Bandcamp and MixCloud) - even those which don’t have download links! It automatically creates ID3 tags as well (including album art), which is handy.

Usage

First, install it:

pip install soundscrape

Then, just call soundscrape and the name of the artist you want to scrape:

soundscrape rabbit-i-am

And you’re done! Hooray! Files are stored as mp3s in the format Artist name - Track title.mp3.

You can also use the -n argument to only download a certain number of songs.

soundscrape rabbit-i-am -n 3

Sets

Soundscrape can also download sets, but you have to include the full URL of the set you want to download:

soundscrape https://soundcloud.com/vsauce-awesome/sets/awesome

Groups

Soundscrape can also download tracks from SoundCloud groups with the -g argument.

soundscrape chopped-and-screwed -gn 2

Tracks

Soundscrape can also download specific tracks with -t:

soundscrape foolsgoldrecs -t danny-brown-dip

or with just the straight URL:

soundscrape https://soundcloud.com/foolsgoldrecs/danny-brown-dip

Likes

Soundscrape can also download all of an Artist’s Liked items with -l:

soundscrape troyboi -l

or with just the straight URL:

soundscrape https://soundcloud.com/troyboi/likes

High-Quality Downloads Only

By default, SoundScrape will try to rip everything it can. However, if you only want to download tracks that have an official download available (which are typically at a higher-quality 320kbps bitrate), you can use the -d argument.

soundscrape sly-dogg -d

Folders

By default, SoundScrape aims to act like wget, downloading in place in the current directory. With the -f argument, however, SoundScrape acts more like a download manager and sorts songs into the following format:

./ARTIST_NAME - ALBUM_NAME/SONG_NUMBER - SONG_TITLE.mp3

It will also skip previously downloaded tracks.

soundscrape murdercitydevils -f

Bandcamp

SoundScrape can also pull down albums from Bandcamp. For Bandcamp pages, use the -b argument along with an artist’s username or a specific URL. It only downloads one album at a time. This works with all of the other arguments, except -d as Bandcamp streams only come at one bitrate, as far as I can tell.

Note: Currently, when using the -n argument, the limit is evaluated for each album separately.

soundscrape warsaw -b -f

Mixcloud

SoundScrape can also grab mixes from Mixcloud. This feature is extremely expermental and is in no way guaranteed to work!

Finds the original mp3 of a mix and grabs that (with tags and album art) if it can, or else just gets the raw m4a stream.

Mixcloud currently only takes an invidiual mix. Capacity for a whole artist’s profile due shortly.

soundscrape https://www.mixcloud.com/corenewsuploads/flume-essential-mix-2015-10-03/ -of

Audiomack

Just for fun, SoundScrape can also download individual songs from Audiomack. Not that you’d ever want to.

soundscrape -a http://www.audiomack.com/song/bottomfeedermusic/top-shottas

Opening Files

As a convenience method, SoundScrape can automatically ‘open’ files that it downloads. This uses your system’s ‘open’ command for file associations.

soundscrape lorn -of

Issues

There’s probably a lot more that can be done to improve this. Please file issues if you find them!

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

soundscrape-0.23.10.tar.gz (13.2 kB view details)

Uploaded Source

Built Distribution

soundscrape-0.23.10-py2-none-any.whl (13.3 kB view details)

Uploaded Python 2

File details

Details for the file soundscrape-0.23.10.tar.gz.

File metadata

File hashes

Hashes for soundscrape-0.23.10.tar.gz
Algorithm Hash digest
SHA256 12a66c8359624b246b63f5cf69d2ee4e8491d8dff8a31b1fc5d64c27a5b2eea2
MD5 b8f5bc0c1ea9e34a5d35456fbb5e71f2
BLAKE2b-256 5e7c879198e1b57c919b16c08d86a7498ab84e805c5af5e81cfacf5914c1c0d2

See more details on using hashes here.

Provenance

File details

Details for the file soundscrape-0.23.10-py2-none-any.whl.

File metadata

File hashes

Hashes for soundscrape-0.23.10-py2-none-any.whl
Algorithm Hash digest
SHA256 14b8d0c967a5c7c1ea96ef59c41d7b23e44f89b92ad190efc5fb0d959c91eda2
MD5 f17cd067e135fa8f37aa3c5a9f55aaeb
BLAKE2b-256 ec7dd9e71943388ce6a9bbfd31d7ae256f742c968e1aca52861b032f68eb3a2e

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page