Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imthaghost/scdl
SoundCloud music downloader 🎶
https://github.com/imthaghost/scdl
download-songs downloader go golang soundcloud soundcloud-client soundcloud-downloader soundcloud-music soundcloud-music-downloader
Last synced: 3 days ago
JSON representation
SoundCloud music downloader 🎶
- Host: GitHub
- URL: https://github.com/imthaghost/scdl
- Owner: imthaghost
- License: mit
- Created: 2020-06-04T09:12:00.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-24T20:51:24.000Z (3 months ago)
- Last Synced: 2024-08-06T23:39:48.495Z (about 2 months ago)
- Topics: download-songs, downloader, go, golang, soundcloud, soundcloud-client, soundcloud-downloader, soundcloud-music, soundcloud-music-downloader
- Language: Go
- Homepage:
- Size: 44.8 MB
- Stars: 58
- Watchers: 2
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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!
![Download](/docs/media/v2.gif)
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Examples](#Examples)
- [Todo](#Todo)
- [License](#license)## 🚀 Installation
### Brew
```bash
# tap
brew tap imthaghost/scdl
# install tool
brew install scdl
```### Manual
```bash
# 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](https://github.com/imthaghost/scdl/releases)
## Usage
``-h, --help`` - Help screen and usage
``-s, --search`` - Option for searching for songs
## Examples
### Base Command
```bash
# command + SounCloud URL
scdl https://soundcloud.com/polo-g/polo-g-feat-juice-wrld-flex
```## Todo
### Short term
- [x] Cobra command line interface
- [x] Download audio file from Soundcloud URL
- [x] Goroutine pool for downloading m3u8 file
- [x] Installation via Brew
- [x] Mp3 file contains image cover
- [x] 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](http://choosealicense.com/licenses/mit/) that covers the project. Feel free to contact the maintainers if that's a concern.