{"id":15145833,"url":"https://github.com/qianbinbin/soundcrawler","last_synced_at":"2026-02-09T11:01:56.598Z","repository":{"id":171536994,"uuid":"647705752","full_name":"qianbinbin/soundcrawler","owner":"qianbinbin","description":"Download SoundCloud tracks along with their metadata and cover art.","archived":false,"fork":false,"pushed_at":"2023-08-04T15:34:35.000Z","size":110,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-05T07:29:43.528Z","etag":null,"topics":["shell","soundcloud"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/qianbinbin.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":"2023-05-31T10:56:02.000Z","updated_at":"2023-09-19T21:57:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"52cd743f-814b-4af4-b8a7-5fe40d2051ef","html_url":"https://github.com/qianbinbin/soundcrawler","commit_stats":{"total_commits":40,"total_committers":1,"mean_commits":40.0,"dds":0.0,"last_synced_commit":"041feab77657b9a92fc864bc50aaf03664a4a742"},"previous_names":["qianbinbin/soundcrawler"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/qianbinbin/soundcrawler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qianbinbin%2Fsoundcrawler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qianbinbin%2Fsoundcrawler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qianbinbin%2Fsoundcrawler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qianbinbin%2Fsoundcrawler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qianbinbin","download_url":"https://codeload.github.com/qianbinbin/soundcrawler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qianbinbin%2Fsoundcrawler/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268074930,"owners_count":24191636,"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","status":"online","status_checked_at":"2025-07-31T02:00:08.723Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["shell","soundcloud"],"created_at":"2024-09-26T11:43:09.670Z","updated_at":"2026-02-09T11:01:51.348Z","avatar_url":"https://github.com/qianbinbin.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SoundCrawler\n\nSoundCrawler is a shell script that allows you to crawl SoundCloud and download tracks along with their metadata and\ncover art.\n\n![](demo.svg)\n\n## Dependencies\n\n- curl\n- jq\n- ffmpeg (if you want to write metadata/cover art to media files or download HLS tracks)\n\n## Usage\n\n```\nUsage: soundcrawler.sh [\u003coptions\u003e] \u003curl\u003e...\nDownload tracks from SoundCloud.\n\n    -i                    print media information instead of downloading the files\n    -M                    do NOT write metadata to media files\n    -C                    do NOT write cover art to media files\n    -I \u003cfile\u003e             read URLs from file\n    -o \u003cdir\u003e              set the output directory\n    -t \u003ctranscoding\u003e      specify a transcoding to use when downloading\n    -h                    display this help and exit\n\nHome page: \u003chttps://github.com/qianbinbin/soundcrawler\u003e\n```\n\n### Examples\n\nTo download a single track:\n\n```sh\n$ soundcrawler.sh https://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt\n```\n\nTo download an album/playlist:\n\n```sh\n$ soundcrawler.sh https://soundcloud.com/dabootlegboy/sets/its-2am-and-i-still-miss-you\n```\n\nTo download all the user's tracks/albums/playlists:\n\n```sh\n$ soundcrawler.sh https://soundcloud.com/takeotakeo/tracks\n$ soundcrawler.sh https://soundcloud.com/takeotakeo/albums\n$ soundcrawler.sh https://soundcloud.com/takeotakeo/sets\n```\n\nTo download in Opus format:\n\n```sh\n$ soundcrawler.sh -t opus-hls https://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt\n```\n\nTo read multiple URLs:\n\n```sh\n$ soundcrawler.sh \\\nhttps://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt \\\nhttps://soundcloud.com/vardenbeats/when-the-sun-sets-rework\n$ cat input.txt # or read from file\nhttps://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt\nhttps://soundcloud.com/vardenbeats/when-the-sun-sets-rework\n$ soundcrawler.sh -I input.txt\n```\n\nTo print media information instead of downloading the files:\n\n```sh\n$ soundcrawler.sh -i https://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt\n==\u003e Fetching client_id...\n==\u003e Fetching track 'https://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt'...\n================================================================================\n  Permalink           https://soundcloud.com/takeotakeo/heated-blanket-w-spencer-hunt\n  ID                  967061290\n  Title               Heated Blanket\n  Artist              tysu \u0026 Spencer Hunt\n  Album               Cozy Winter\n  Cover Art           https://i1.sndcdn.com/artworks-eHM1Jhho6GkSTg2m-jrUWsQ-t500x500.jpg\n--------------------------------------------------------------------------------\n  Transcodings        # Available formats and qualities\n--------------------------------------------------------------------------------\n  - Preset            mp3_0_1\n    MIME Type         audio/mpeg\n    Protocol          hls\n    Quality           sq\n  # Download With     soundcrawler.sh -t mp3-hls [\u003coptions\u003e] \u003curl\u003e...\n--------------------------------------------------------------------------------\n  - Preset            mp3_0_1\n    MIME Type         audio/mpeg\n    Protocol          progressive\n    Quality           sq\n  # Download With     soundcrawler.sh -t mp3 [\u003coptions\u003e] \u003curl\u003e...\n--------------------------------------------------------------------------------\n  - Preset            opus_0_0\n    MIME Type         audio/ogg; codecs=\"opus\"\n    Protocol          hls\n    Quality           sq\n  # Download With     soundcrawler.sh -t opus-hls [\u003coptions\u003e] \u003curl\u003e...\n```\n\n## License\n\n[MIT](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqianbinbin%2Fsoundcrawler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqianbinbin%2Fsoundcrawler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqianbinbin%2Fsoundcrawler/lists"}