Skip to main content

Soundcloud command-line utility

Project description

soundcloud-cli is a command-line interface for SoundCloud. It allows you to compress and upload audio to SoundCloud, among other things.


Preferred method of install is pip:

$ pip install soundcloud-cli

After installing sc, you should authenticate using sc auth.


Check usage for detailed arguments:

$ sc --help


Authenticate against SoundCloud and save access_token. Required to upload audio.

$ sc auth
Enter username (zeekay): requite
Enter password:
Saved access_token.

You can run sc auth to change users later.


Set values to be used as defaults for commands.

$ sc defaults share_with zeekay
set share_with = ['zeekay']


List your tracks, or tracks for a given user.

$ sc list sinerise
tracks by sinerise:
  Dane Pedersen - Space Jambience (Sinerise Remix)
  Strewn (51st Vocal Mix) feat. delica     
  Calling (requite's bass refix)           
  Can't Save Me                            
  Calling (Original)                       


Share a track with a set of users on SoundCloud.

$ sc share zeekay
shared with:
  zeekay (


You can use the sc upload command to upload audio to SoundCloud. If you specify a .wav file sc will compress the audio for you (if lame is installed). By default uploaded audio is set to private, and you’ll get the secret link for sharing:

$ sc honey.wav
uploading honey.mp3 [==================================================] 100%

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
soundcloud-cli-0.2.7.tar.gz (9.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page