flyingrub
/
scdl
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
48 Commits
1 Branch
0 Tags
394 KiB
Python 100%
 
Go to file
mauricebasement cb9e63ab20 bugfix of windows cmd 
The replacement of the longdash needs to take place before the first print argument using the title string, to fix the bug on windows command line interface.
 		2015-04-21 12:30:58 +02:00
config Default Download path is now current folder 2015-04-21 12:30:58 +02:00
scdl bugfix of windows cmd 2015-04-21 12:30:58 +02:00
.gitignore somefix 2015-04-21 12:30:58 +02:00
LICENSE Initial commit 2014-10-02 21:37:43 +02:00
MANIFEST.in Introduce setup.py 2015-04-21 12:28:48 +02:00
README.md somefix 2015-04-21 12:30:58 +02:00
setup.py fix: configparser is built in with python3 2015-04-21 12:30:58 +02:00

README.md

Logo

# Soundcloud Music Downloader ## Description

This script is able to download music from http://www.soundcloud.com and set id3tag to the downloaded music. It should work with OS X, Linux, Windows.

System requirements

  • Python3

Instructions

Installation

  1. Install scdl pip3 install scdl
  2. (Optional) Setup your path and your auth_token in $HOME/.config/scdl/scdl.cfg

Authentication:

Get your auth token here: Token

  • This allows scdl to access to your user profile data.
  • You need to have this set to be able to use the me option
  • Soon scdl will be able to download a user's stream

Help

Usage:

  scdl -l <track_url> [-a | -f | -t | -p][-c][-o <offset>][--hidewarnings][--addtofile]
  scdl me (-s | -a | -f | -t | -p)[-c][-o <offset>][--hidewarnings][--addtofile]
  scdl -h | --help
  scdl --version

Options:

  -h --help          Show this screen.
  --version          Show version.
  me                 Uses the auth_token specified in the config to get access to the user's profile
  -l [url]           URL can be a track, playlist or a user.
  -s                 Download the stream of a user (token needed)
  -a                 Download all of a user's tracks, including reposts
  -t                 Download all of a user's uploads
  -f                 Download all of a user's favorites
  -p                 Download all of a user's playlists
  -c                 Continue if a music already exist
  -o [offset]        Start on a custom offset.
  --hidewarnings     Hide Warnings. Use with precaution
  --addtofile        Add the artist name to the filename if it isn't in the filename already
  --path             Path to download directory, can be set in the config. If none of this is set, it uses the current working directory
  --silent           Disables output, useful for scripters

Features

  • Automatically detect the type of link provided
  • Download all songs from a user
  • Download all songs and reposts from a user
  • Download all songs from one playlist
  • Download all songs from all playlists from a user
  • Download all songs from a user's favorites
  • Set the tags with mutagen (Title / Artist / Album = 'Soundcloud' / Artwork)

License

GPL v2, orignal author Flyingrub