#SMLoadr > A streaming music downloader. ![Screenshot](screenshot.png) 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 ./SMLoadr-linux-x64 ``` ###CLI: ``` chmod +x SMLoadr-linux-x64 ./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](https://play.google.com/store/apps/details?id=com.termux) - Apk Mirror: [link](https://www.apkmirror.com/apk/fredrik-fornwall/termux) ### 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 nodejs git ``` ### 3. Download First download the latest version from the repo: ``` git clone --depth 1 https://git.teknik.io/SMLoadrDev/SMLoadr.git ``` ### 4. Install Move files and remove unnecessary ones: ``` mv SMLoadr/{package.json,SMLoadr.js} ./ rm -r SMLoadr ``` Now we install what we've downloaded: ``` npm install ``` Patch openurl: ``` sed -i 's/linux/android/' node_modules/openurl/openurl.js ``` ### 5. Setup storage 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.