#SMLoadr

A streaming music downloader.

SMLoadr is a program for downloading music from streaming music services.

It is intended for educational and private use only, and not as a tool for pirating and distributing music!

Remember that the artists and studios put a lot of work into making music - purchase music to support them.

Features

• Download music in excellent quality for free
• Supports single tracks, albums, artists, playlists and users favourite tracks
• Music quality selection (MP3 - 128 kbps, MP3 - 320 kbps, FLAC - 1411 kbps)
• Auto tagging MP3 & FLAC files (with album cover)
• Saves music to "DOWNLOADS/[artist]/[album]/[track_number] [title].mp3/flac"
• Download a list of links from "downloadLinks.txt"
• CLI support

Supported sites

• Currently only Deezer is supported.
• We'll add more in the future ;)

Supported platforms

• Windows x64
• Windows x86
• Linux x64
• Linux x86
• MacOS x64
• Android (Run from source, see guide below)
• ARM like Raspberry Pi (Run from source)

How to use (Windows)

Run it as admin if you get "EPERM: operation not permitted..." error!

###Interactive:

Double click the exe :)

###CLI:

.\SMLoadr-win-x64.exe -q "MP3_128" -p "DOWNLOADS/" "http://www.deezer.com/album|artist|playlist|profile|track/0123456789"

How to use (Linux/MacOS)

See "How to use (from source)" to run it on ARM devices like the Raspberry Pi.

###Interactive:

chmod +x
./SMLoadr-linux-x64

###CLI:

chmod +x
./SMLoadr-linux-x64 -q "MP3_128" -p "DOWNLOADS/" "http://www.deezer.com/album|artist|playlist|profile|track/0123456789"

How to use (Android)

Installing SMLoadr on Android is a little bit complicated :/

1. Install Termux

In order to run SMLoadr on Android you have to install Termux.

• Play Store: link
• Apk Mirror: link

2. Install dependencies

Run Termux and enter these lines in the given order (If it asks you if you want to continue, enter y):

pkg update
pkg upgrade
pkg install git nodejs

3. Download

First download the latest version from the repo:

git clone --depth 1 https://git.teknik.io/SMLoadrDev/SMLoadr.git

4. Install

mv SMLoadr/{package.json,SMLoadr.js} ./ rm -r SMLoadr

Now we install what we've downloaded:

npm install

In order to let SMLoadr download to the right folder, we need to setup storage for `Termux`:

termux-setup-storage

Now we trick SMLoadr into downloading to the public storage:

mkdir ~/storage/shared/SMLoadr ln -s ~/storage/shared/SMLoadr DOWNLOADS

### 6. Run
Last but not least run the app (downloaded files will be in a folder named SMLoadr in public storage):

node SMLoadr.js

### 7. Updating
To update it, run step 3 and step 4


## How to use (from source)

To run it from source download the repo and execute the following commands in the directory:

npm i node SMLoadr.js

## CLI parameters

| Parameter            | Short               | Default          | Supported values                        | Description                          |
| :-----------------   | :------------------ | :--------------- | :-------------------------------------- | :----------------------------------- |
| ```--quality```      | ```-q```            | ```MP3_320```    | MP3_128/MP3_320/FLAC            | The quality of the files to download |
| ```--path```         | ```-p```            | ```DOWNLOADS/``` | Path with / in the end                  | The path to download the files to    |
| ```--url```          | ```-u or nothing``` |                  | album/artist/playlist/profile/track url | Downloads single deezer url          |
| ```--downloadmode``` | ```-d```            | ```single```     | ```all``` for "downloadLinks.txt"       | Downloads multiple urls from list    |
| ```--help```         | ```-h```            |                  | _Nothing_                               | Shows the CLI help                   |



## Downloads

- Get stable releases here: [https://git.teknik.io/SMLoadrDev/SMLoadr/releases](https://git.teknik.io/SMLoadrDev/SMLoadr/releases)
- Telegram news channel: [https://t.me/SMLoadrNews](https://t.me/SMLoadrNews)
- Telegram community group: [https://t.me/SMLoadrCommunity](https://t.me/SMLoadrCommunity)
- Telegram off-topic group: [https://t.me/SMLoadrOffTopic](https://t.me/SMLoadrOffTopic)



## Donate

- **BTC:** 15GktD5M1kCmESyxfhA6EvmhGzWnRA8gvg
- **BTC Cash:** 1LpLtLREzTWzba94wBBpJxcv7r6h6u1jgF
- **ETH:** 0xd07c98bF53b21c4921E7b30491Fe0B86E714afeD
- **ETH Classic:** 0x7b8f83e4cE082BfCe5B6f6E4F204c914e925f242
- **LTC:** LXJwhRmjfUruuwp76rJmLrhJJjHSG8TNxm
- **DASH:** XmHzFcygcwtqabgfEtJyq9cen1G5EnvuGR



## Disclaimer

- We do **not** call to commit crimes.
- The usage of this tool **may be illegal** in your country! Please inform yourself.
- We do **not** give any guarantee at all and we am **not** responsible for damages of all kinds!



---
> Made with :heart: & :beer: by SMLoadrDevs | Copyright © 2018 SMLoadrDevs.