Skip to content

๐Ÿ”Šโ˜๏ธ Simple CLI to fetch SoundCloud tracks

License

Notifications You must be signed in to change notification settings

timoknapp/soundcloud-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ”Šโ˜๏ธ soundcloud-cli

Simple CLI to fetch the SoundCloud streams

Getting started

Build

You can either build it yourself or just download the latest build from here. If you want build it yourself, you can use the Makefile with you desired architeture:

# build for linux
make build-linux

# build for Raspberry
make build-linux-arm

# build for Mac
make build-mac

# build for Mac ARM
make build-mac-arm

# build for Windows
make build-windows

Info

./sc -h
NAME:
   SoundCloud CLI - A simple CLI to interact with tracks on SoundCloud

USAGE:
   main [global options] command [command options] [arguments...]

VERSION:
   1.0.0

COMMANDS:
   download, dl  Download a track
   meta, m       Show metadata for a track
   search, ls    Search for tracks
   help, h       Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help (default: false)
   --version, -v  print the version (default: false)

Run

Search:

./sc ls --limit 5 andhim
     ID     |             TITLE              |                                URL                                  
------------+--------------------------------+---------------------------------------------------------------------
  177318577 | Elderbrook x Andhim - How Many | https://soundcloud.com/andhim/elderbrook-how-many-times-andhim-rmx  
            | Times                          |                                                                     
  29552513  | Theophilus London - Wine &     | https://soundcloud.com/andhim/wine-and-chocolate-andhim-rmx         
            | Chocolates (andhim rmx)        |                                                                     
  90830301  | Hausch                         | https://soundcloud.com/andhim/andhim-hausch                         
  112750743 | Boy Boy Boy                    | https://soundcloud.com/andhim/andhim-boy-boy-boy                    
  99537297  | andhim live at Fusion Festival | https://soundcloud.com/andhim/andhim-live-at-fusion                 

Download:

./sc download -h
NAME:
   main download - Download a track

USAGE:
   main download [command options] [arguments...]

OPTIONS:
   --path value     Path where the files will be stored (default: "download")
   --quality value  Quality of the track (default: "mp3")
   --help, -h       show help (default: false)


# By ID >
./sc download $TRACK_ID
# By URL >
./sc download $TRACK_URL

Features

  • Download tracks by URL or ID
  • Search tracks
  • Show metadata for a track
  • ID3 Tags
  • Support multiple system-architectures

Planned Features

  • Support multiple tracks download (e.g. by playlist URL)

Contribution

PRs Welcome :)