{"id":13502439,"url":"https://github.com/Miserlou/SoundScrape","last_synced_at":"2025-03-29T10:32:59.696Z","repository":{"id":12840487,"uuid":"15516057","full_name":"Miserlou/SoundScrape","owner":"Miserlou","description":"SoundCloud (and Bandcamp and Mixcloud) downloader in Python. ","archived":false,"fork":false,"pushed_at":"2024-06-23T16:29:11.000Z","size":294,"stargazers_count":1417,"open_issues_count":71,"forks_count":146,"subscribers_count":42,"default_branch":"master","last_synced_at":"2024-10-29T17:56:03.174Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Miserlou.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-12-29T22:32:46.000Z","updated_at":"2024-10-28T06:52:43.000Z","dependencies_parsed_at":"2024-11-26T15:15:11.896Z","dependency_job_id":null,"html_url":"https://github.com/Miserlou/SoundScrape","commit_stats":{"total_commits":221,"total_committers":14,"mean_commits":"15.785714285714286","dds":"0.25339366515837103","last_synced_commit":"800c1bfcad378d2de061e3b7964d59fe8b811862"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Miserlou%2FSoundScrape","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Miserlou%2FSoundScrape/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Miserlou%2FSoundScrape/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Miserlou%2FSoundScrape/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Miserlou","download_url":"https://codeload.github.com/Miserlou/SoundScrape/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246174208,"owners_count":20735406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T22:02:14.010Z","updated_at":"2025-03-29T10:32:59.660Z","avatar_url":"https://github.com/Miserlou.png","language":"Python","readme":"![SoundScrape!](http://i.imgur.com/nHAt2ow.png)\n\nSoundScrape [![Build Status](https://travis-ci.org/Miserlou/SoundScrape.svg)](https://travis-ci.org/Miserlou/SoundScrape) [![Python 3](https://img.shields.io/badge/Python-3-brightgreen.svg)](https://pypi.python.org/pypi/soundscrape/) [![PyPI](https://img.shields.io/pypi/v/soundscrape.svg)](https://pypi.python.org/pypi/SoundScrape)\n==============\n\n**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.\n\nUsage\n---------\n\nFirst, install it:\n\n```bash\npip install soundscrape\n```\n\nNote that if you are having problems, please first try updating to the latest version:\n\n```bash\npip install soundscrape --upgrade\n```\n\nThen, just call soundscrape and the name of the artist you want to scrape:\n\n```bash\nsoundscrape rabbit-i-am\n```\n\nAnd you're done! Hooray! Files are stored as mp3s in the format **Artist name - Track title.mp3**.\n\nYou can also use the *-n* argument to only download a certain number of songs.\n\n```bash\nsoundscrape rabbit-i-am -n 3\n```\n\nSets\n-------\n\nSoundscrape can also download sets, but you have to include the full URL of the set you want to download:\n\n```bash\nsoundscrape https://soundcloud.com/vsauce-awesome/sets/awesome\n```\n\nGroups\n--------\n\nSoundscrape can also download tracks from SoundCloud groups with the *-g* argument.\n\n```bash\nsoundscrape chopped-and-screwed -gn 2\n```\n\nTracks\n--------\n\nSoundscrape can also download specific tracks with *-t*:\n\n```bash\nsoundscrape foolsgoldrecs -t danny-brown-dip\n```\n\nor with just the straight URL:\n\n```bash\nsoundscrape https://soundcloud.com/foolsgoldrecs/danny-brown-dip\n```\n\nLikes\n--------\n\nSoundscrape can also download all of an Artist's Liked items with *-l*:\n\n```bash\nsoundscrape troyboi -l\n```\n\nor with just the straight URL:\n\n```bash\nsoundscrape https://soundcloud.com/troyboi/likes\n```\n\nHigh-Quality Downloads Only\n--------\n\nBy 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.\n\n```bash\nsoundscrape sly-dogg -d\n```\n\nKeep Preview Tracks\n--------\n\nBy default, SoundScrape will skip the 30-second preview tracks that SoundCloud now provides. You can choose to keep these preview snippets with the *-k* argument.\n\n```bash\nsoundscrape chromeo -k\n```\n\nFolders\n--------\n\nBy 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:\n\n```\n./ARTIST_NAME - ALBUM_NAME/SONG_NUMBER - SONG_TITLE.mp3\n```\n\nIt will also skip previously downloaded tracks.\n\n```bash\nsoundscrape murdercitydevils -f\n```\n\nBandcamp\n--------\n\nSoundScrape 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.\n\nNote: Currently, when using the *-n* argument, the limit is evaluated for each album separately.\n\n```bash\nsoundscrape warsaw -b -f\n```\n\nThis also works for non-Bandcamp URLs that are hosted on Bandcamp:\n\n```bash\nsoundscrape -b http://music.monstercat.com/\n```\n\nNote that the full URL must be included.\n\nMixcloud\n--------\n\nSoundScrape can also grab mixes from Mixcloud. This feature is extremely expermental and is in no way guaranteed to work!\n\nFinds 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.\n\nMixcloud currently only takes an invidiual mix. Capacity for a whole artist's profile due shortly.\n\n```bash\nsoundscrape https://www.mixcloud.com/corenewsuploads/flume-essential-mix-2015-10-03/ -of\n```\n\nAudiomack\n--------\n\nJust for fun, SoundScrape can also download individual songs from Audiomack. Not that you'd ever want to.\n\n```bash\nsoundscrape -a http://www.audiomack.com/song/bottomfeedermusic/top-shottas\n```\n\nMusicBed\n--------\n\nFor some strange reason, it also works for MusicBed.com. Thanks @brachna for this feature.\n\n```bash\nsoundscrape https://www.musicbed.com/albums/be-still/2828\n```\n\nOpening Files\n--------\n\nAs a convenience method, SoundScrape can automatically _'open'_ files that it downloads. This uses your system's 'open' command for file associations.\n\n```bash\nsoundscrape lorn -of\n```\n\nIssues\n-------\n\nThere's probably a lot more that can be done to improve this. Please file issues if you find them!\n","funding_links":[],"categories":["Python","📜 SCRIPTS","Command-line apps","HarmonyOS","[](#table-of-contents) Table of contents"],"sub_categories":["🔉 Download audio from SoundCloud","Windows Manager","[](#universal)Universal"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMiserlou%2FSoundScrape","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMiserlou%2FSoundScrape","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMiserlou%2FSoundScrape/lists"}