Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/timoknapp/soundcloud-cli

🔊☁️ Simple CLI to fetch SoundCloud tracks
https://github.com/timoknapp/soundcloud-cli

golang hacktoberfest soundcloud soundcloud-api soundcloud-downloader

Last synced: 25 days ago
JSON representation

🔊☁️ Simple CLI to fetch SoundCloud tracks

Awesome Lists containing this project

README

        

# 🔊☁️ 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](https://github.com/timoknapp/soundcloud-cli/releases). 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 :)