Skip to content

Soundcloud music downloader for Unix, Linux and Mac OS X written in BASH. (Private use only!)

Notifications You must be signed in to change notification settings

pepijnblom/soundcloud-dl

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo

Souncloud Music Downloader

Python Version

  • FlyinGrub has decided to change the language, because the bash one started to be a little too messy...
  • He has choosen python cause it's nice, simple, efficient but more :
    • There is a lot of tool made by the community (like eyed3) that can be imported very easily
    • It allow an easier installation
    • It will be fully compatible with Linux/Os x/Windows without hacking (like previously for os x)
  • It already fixes all the issues of the bash version and add others features.
  • You can find it here

Changelog : MUST READ !

  • the .scdl.cfg has been changed a few time ago before reporting any issue be sure you have the latest one in your $HOME !!
  • Please read the new instructions below, if you want to update/install/reinstall

Description

This shell script is able to download music from http://www.soundcloud.com. It should work with OS X, any Linux OS.

System requirements

  • Unix like OS with a proper shell
  • Tools we use : sed ; tr ; echo ; grep ; cut ; sort ; uniq.

Required tools

  • You will need eyeD3 ; curl
  • Only OSX : brew

Instructions

Just in case :

  1. Download this
  2. Unzip

Lazy Install :

  1. You can use the auto installer : ./install (Support Debian/arch/osX)
  2. Check that your .scdl.cfg is in $HOME
  3. Add you own path to it
  4. Check that there is a clientID and add your own if you want

Manual Install :

  1. Place .scdl.cfg in your $HOME
  2. Add you own path to it
  3. Check that there is a clientID and add your own if you want
  4. Be sure that you have all the required tools.
  5. Place scdl in a folder that is in your $PATH (/usr/local/bin/ on OSX, /usr/bin/ for other distro by default)

Fire :

  1. Type scdl {OPTION} -l {URL}
  • For help type scdl -h

OPTIONS available

  • -l [URL] Use this Url. (Necessary)
  • -o [OFFSET] Begin the download with a custom offset.
  • -p [PATH] Use a custom path for this time.
  • -c Script will continue if a sound as already been downloaded.
  • -r Download only the repost.
  • -d Debug mode.
  • -h Show this help.

Features

  • Easy Installer
  • Automatically detect which kind of Soundcloud's link you have provided
  • Download all song of an user's page
  • Download all repost of an user's page
  • Download all song of a song page
  • Download all song of an user's playlist page
  • Download all song of an user's list of playlist page
  • Download all song of a group page
  • Download all song of an user's liked song
  • Set tags with eyeD3 (skip the tag if eyeD3 is not installed)
  • The script stop when he see one song that is already downloaded
  • You can use it as a sync script as i do with my Raspberry PI, each night it launch the script with my soudncloud and if new song has been reposted it download it and stop when it encounter a song that has already been downloaded.

License

GPL v2, orignal author Luka Pusic

About

Soundcloud music downloader for Unix, Linux and Mac OS X written in BASH. (Private use only!)

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%