Scrape an artist from SoundCloud
Project description
SoundScrape [](https://travis-ci.org/Miserlou/SoundScrape) []()
==============
/**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:
```bash
pip install soundscrape
```
Then, just call soundscrape and the name of the artist you want to scrape:
```bash
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.
```bash
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:
```bash
soundscrape https://soundcloud.com/vsauce-awesome/sets/awesome
```
Groups
--------
Soundscrape can also download tracks from SoundCloud groups with the *-g* argument.
```bash
soundscrape chopped-and-screwed -gn 2
```
Tracks
--------
Soundscrape can also download specific tracks with *-t*:
```bash
soundscrape foolsgoldrecs -t danny-brown-dip
```
or with just the straight URL:
```bash
soundscrape https://soundcloud.com/foolsgoldrecs/danny-brown-dip
```
Likes
--------
Soundscrape can also download all of an Artist's Liked items with *-l*:
```bash
soundscrape troyboi -l
```
or with just the straight URL:
```bash
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.
```bash
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 in to ./ARTIST_NAME/ARTIST_NAME_SONG_TITLE.mp3 format. It will also skip previously downloaded tracks.
```bash
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.
```bash
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.
```bash
soundscrape https://www.mixcloud.com/corenewsuploads/flume-essential-mix-2015-10-03/ -of
```
Audiomack
--------
Just for fun, SoundCloud can also download individual songs from Audiomack. Not that you'd ever want to.
```bash
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.
```bash
soundscrape lorn -of
```
Issues
-------
There's probably a lot more that can be done to improve this. Please file issues if you find them!
SoundScrape [](https://travis-ci.org/Miserlou/SoundScrape) []()
==============
/**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:
```bash
pip install soundscrape
```
Then, just call soundscrape and the name of the artist you want to scrape:
```bash
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.
```bash
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:
```bash
soundscrape https://soundcloud.com/vsauce-awesome/sets/awesome
```
Groups
--------
Soundscrape can also download tracks from SoundCloud groups with the *-g* argument.
```bash
soundscrape chopped-and-screwed -gn 2
```
Tracks
--------
Soundscrape can also download specific tracks with *-t*:
```bash
soundscrape foolsgoldrecs -t danny-brown-dip
```
or with just the straight URL:
```bash
soundscrape https://soundcloud.com/foolsgoldrecs/danny-brown-dip
```
Likes
--------
Soundscrape can also download all of an Artist's Liked items with *-l*:
```bash
soundscrape troyboi -l
```
or with just the straight URL:
```bash
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.
```bash
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 in to ./ARTIST_NAME/ARTIST_NAME_SONG_TITLE.mp3 format. It will also skip previously downloaded tracks.
```bash
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.
```bash
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.
```bash
soundscrape https://www.mixcloud.com/corenewsuploads/flume-essential-mix-2015-10-03/ -of
```
Audiomack
--------
Just for fun, SoundCloud can also download individual songs from Audiomack. Not that you'd ever want to.
```bash
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.
```bash
soundscrape lorn -of
```
Issues
-------
There's probably a lot more that can be done to improve this. Please file issues if you find them!
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.19.0.tar.gz
(10.7 kB
view details)
File details
Details for the file soundscrape-0.19.0.tar.gz.
File metadata
- Download URL: soundscrape-0.19.0.tar.gz
- Upload date:
- Size: 10.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 070bb1b452328dc6af6c81e72dbff2276649742943f4b76ddd94478651d827a3 |
|
| MD5 | e96e98a23069d092a4df69ecbea23ecb |
|
| BLAKE2b-256 | 7ef7426b6b4b27a8982e32c2239ab78c3df66509a60046cefb00568a7a81d07d |
