https://github.com/ayehia0/soundcloud-dl

A small CLI tool to download SoundCloud tracks and playlists, written in Go lang.
https://github.com/ayehia0/soundcloud-dl

cli go soundcloud

Last synced: 4 months ago
JSON representation

A small CLI tool to download SoundCloud tracks and playlists, written in Go lang.

• Host: GitHub
• URL: https://github.com/ayehia0/soundcloud-dl
• Owner: AYehia0
• Created: 2022-09-17T20:40:08.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-04-23T13:38:12.000Z (9 months ago)
• Last Synced: 2024-10-10T00:43:54.189Z (4 months ago)
• Topics: cli, go, soundcloud
• Language: Go
• Homepage:
• Size: 5.15 MB
• Stars: 85
• Watchers: 2
• Forks: 9
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


    





SoundCloud-dl


![Go](https://img.shields.io/badge/go-%2300ADD8.svg?style=for-the-badge&logo=go&logoColor=white)

![Sound Cloud](https://img.shields.io/badge/sound%20cloud-FF5500?style=for-the-badge&logo=soundcloud&logoColor=white)



A simple CLI app written in GO used to download sound-tracks from soundcloud with a nice UI and some cool features like downloading with multiple formats/qualities and search.

# Overview

`soundcloud-dl` is a compiled CLI app that uses the soundcloud API to :

- Download tracks by URL.

- Search in-app and download.

- Save tracks with tags/metadata : `Artwork Image`, `Creation Date`, `Author Name`.

- Multiple formats and qualities.

- [Blazingly Fast](https://youtu.be/Z0GX2mTUtfo)

- Download playlists.

- Download user's tracks and playlists. (coming soon).

# Installation

There are multiple ways to install, the easiest is :

```

go install github.com/AYehia0/soundcloud-dl@latest

```

other way is to grab is the source code and build.

# How to use ?

Make sure to read the help menu.

```

Usage:

  sc  [flags]

Flags:

  -b, --best                   Download with the best available quality.

  -p, --download-path string   The download path where tracks are stored. (default "/home/none/Things/github/soundcloud-dl")

  -h, --help                   help for sc

  -s, --search-and-download    Search for tracks by title and prompt one for download 

  -v, --version                version for sc

```

Notes : `-s` can't work with a `url` passed.

- **Download through a given URL**



    



- **Download through search**

Note: search is limited to 6 results of type `track`, later on maybe `playlist` will be added. Also pagination may be add!.



    



- **Download a playlist**

Note : when downloading a playlist, it uses the flag `--best` to grab the best quality.