yyolk/soundcloud-syncer

A tool to sync user's favorites tracks in soundcloud

Soundcloud Syncer

Soundcloud-syncer is a tool to synchronize soundcloud user’s favorites and tracks locally.

Requirements

Python version

1. Python 3.2.

Run unittests

To run unitests you will need following packages:

• mock

Optionnaly you can install these packages:

• nose
• coverage

pip-3.2 install mock nose coverage

Usage

• Clone repository:

git clone https://github.com/Sliim/soundcloud-syncer.git

• Move into cloned directory and run sync.py script:

mv soundcloud-syncer
./sync.py --help

Basic usage

• Download user’s likes:

./sync.py -u USER_TO_SYNC -o OUTPUT_DIRECTORY

• Download user’s tracks:

./sync.py -u USER_TO_SYNC -o OUTPUT_DIRECTORY -t

• You can download tracks recursively:

./sync.py -u USER_TO_SYNC -o OUTPUT_DIRECTORY -t -r

• To set offset and limit for tracks list:

./sync.py -u USER_TO_SYNC -o OUTPUT_DIRECTORY -L LIMIT -O OFFSET

/!\ Limit can’t be greater than 200.

Ignoring tracks

You can ignore some tracks you don’t want to sync locally.

To do this create a file in OUTPUT_DIRECTORY named .ignore. Each track in this file will be ignored.

• Example:

To ignore https://soundcloud.com/trapmusic/vexed-goodbye-by-j-nitrous add in .ignore file:

trapmusic/vexed-goodbye-by-j-nitrous

Features

• Download user’s favorites / likes tracks list.
• Download user’s tracks list.
• Possibility to set offset and limit for tracks list.
• Auto find client_id when not passed to sync script.
• Check if track exists locally before download it.
• Possibility to ignore some tracks to sync.
• Recursive download.

License

See COPYING file