scdl/

README

Scdl is the fastest SoundCloud music downloading CLI tool. Scdl utilizes a go routine pool ensuring multiple thread safe and fast downloads from SoundCloud within seconds. There are extended features such as search (no URL needed) recursively downloading all songs from a given playlist and more!

Table of Contents

• Installation
• Usage
• Examples
• Todo
• License

🚀 Installation

Brew

# tap
brew tap imthaghost/scdl
# install tool
brew install scdl

Manual

# go get :)
go get https://github.com/imthaghost/scdl
# change to project directory using your GOPATH
cd $GOPATH/src/github.com/imthaghost/scdl/cmd/scdl
# build and install application
go install

Binary

Download Here

Usage

-h, --help - Help screen and usage

-s, --search - Option for searching for songs

Examples

Base Command

# command + SounCloud URL
scdl https://soundcloud.com/polo-g/polo-g-feat-juice-wrld-flex

Search

# search flag
scdl lucid dreams --search
# or
scdl lucid dreams -s

Todo

Short term

• Cobra command line interface
• Download audio file from Soundcloud URL
• Goroutine pool for downloading m3u8 file
• Installation via Brew
• Mp3 file contains image cover
• Download a song through search functionality
• 80-100% test coverage
• Update tool for better performance
• Proxy flag
• Format flag

Long term

• Search results
• Download all songs from a given playlist
• Download all songs from a given album

📝 License

By contributing, you agree that your contributions will be licensed under its MIT License.

In short, when you submit code changes, your submissions are understood to be under the same MIT License that covers the project. Feel free to contact the maintainers if that's a concern.