172 lines
6.9 KiB
Markdown
172 lines
6.9 KiB
Markdown
Yandex Music Downloader
|
|
=====================
|
|
[](https://www.perl.org/) [](https://raw.githubusercontent.com/kaimi-io/yandex-music-download/master/LICENSE)
|
|
|
|
[](https://t.me/kaimi_io)
|
|
[](https://twitter.com/kaimi_io)
|
|
|
|
|
|
|
|
Simple command line Perl script for downloading music from Yandex Music (http://music.yandex.ru).
|
|
Origin of the script is the following article: https://kaimi.io/2013/11/yandex-music-downloader/.
|
|
|
|
## Contents
|
|
- [Requirements](#Requirements)
|
|
- [Environment](#Environment)
|
|
- [Perl modules](#Perl-modules)
|
|
- [Installation](#Installation)
|
|
- [Ubuntu / Debian](#ubuntu--debian)
|
|
- [MacOS](#MacOS)
|
|
- [Windows](#Windows)
|
|
- [Docker](#Docker)
|
|
- [Usage](#Usage)
|
|
- [Frequently Asked Questions (FAQ)](#FAQ)
|
|
- [Contribute](#Contribute)
|
|
- [License](#License)
|
|
|
|
## Requirements
|
|
### Environment
|
|
* Linux/Windows/MacOS (anything, that runs Perl)
|
|
* Perl >= 5.12
|
|
|
|
### Perl modules
|
|
* General
|
|
* Digest::MD5
|
|
* File::Copy
|
|
* File::Spec
|
|
* File::Temp
|
|
* Getopt::Long::Descriptive
|
|
* HTML::Entities
|
|
* HTTP::Cookies
|
|
* JSON::PP
|
|
* LWP::Protocol::https
|
|
* LWP::UserAgent
|
|
* MP3::Tag
|
|
* Term::ANSIColor
|
|
* Mozilla::CA
|
|
|
|
* Windows-only modules
|
|
* Win32::API
|
|
* Win32::Console
|
|
* Win32API::File
|
|
|
|
## Installation
|
|
### Ubuntu / Debian
|
|
```bash
|
|
# Prerequisites
|
|
sudo apt-get update
|
|
sudo apt-get -y install perl cpanminus make git
|
|
sudo apt-get -y install libwww-perl liblwp-protocol-https-perl libhttp-cookies-perl libhtml-parser-perl libmp3-tag-perl libgetopt-long-descriptive-perl libarchive-zip-perl
|
|
cpanm Mozilla::CA
|
|
|
|
# Get a copy and run
|
|
git clone https://github.com/kaimi-io/yandex-music-download.git
|
|
cd yandex-music-download/src
|
|
perl ya.pl -h
|
|
```
|
|
### MacOS
|
|
1. Install brew (https://brew.sh/).
|
|
2. Run:
|
|
```bash
|
|
brew update
|
|
brew install perl cpanminus git
|
|
cpanm Digest::MD5 File::Copy File::Spec File::Temp Getopt::Long::Descriptive HTML::Entities HTTP::Cookies JSON::PP LWP::Protocol::https LWP::UserAgent MP3::Tag Term::ANSIColor Mozilla::CA
|
|
|
|
git clone https://github.com/kaimi-io/yandex-music-download.git
|
|
cd yandex-music-download/src
|
|
perl ya.pl -h
|
|
```
|
|
### Windows
|
|
With WSL (Windows Subsystem for Linux) installation will be similar to [Ubuntu / Debian](#ubuntu--debian).
|
|
Otherwise:
|
|
1. Download and install ActiveState Perl (https://www.activestate.com/products/perl/downloads/) or Strawberry Perl (http://strawberryperl.com/).
|
|
2. Ensure, that Perl was added to system `PATH` environment variable.
|
|
3. From Windows command line run:
|
|
```perl -v```. It should output Perl version. If not, refer to your Perl distribution documentation about adding Perl to your `PATH` environment variable.
|
|
|
|
4. Install required modules (it can be done via PPM if you're using ActiveState Perl):
|
|
```bash
|
|
cpan install Digest::MD5 File::Copy File::Spec File::Temp Getopt::Long::Descriptive HTML::Entities HTTP::Cookies JSON::PP LWP::Protocol::https LWP::UserAgent MP3::Tag Term::ANSIColor Mozilla::CA Win32::API Win32::Console Win32API::File
|
|
```
|
|
5. Download and unpack Yandex Music Downloader (https://github.com/kaimi-io/yandex-music-download/archive/master.zip).
|
|
6. Run:
|
|
```bash
|
|
cd yandex-music-download/src
|
|
perl ya.pl -h
|
|
```
|
|
|
|
### Docker
|
|
1. Install Docker (https://docs.docker.com/get-docker/).
|
|
2. Run:
|
|
```bash
|
|
git clone https://github.com/kaimi-io/yandex-music-download.git
|
|
cd yandex-music-download
|
|
docker build --tag yandex-music-downloader:1.0 .
|
|
docker run --init --rm -v $(PWD):/root/ --name yamusic yandex-music-downloader:1.0 -d /root --cookie "Session_id=..." -u https://music.yandex.ru/album/215688/track/1710808
|
|
```
|
|
|
|
## Usage
|
|
```bat
|
|
Yandex Music Downloader v1.1
|
|
|
|
ya.pl [-adklpstu] [long options...]
|
|
-p[=INT] --playlist[=INT] playlist id to download
|
|
-k[=STR] --kind[=STR] playlist kind (eg. ya-playlist,
|
|
music-blog, music-partners, etc.)
|
|
-a[=INT] --album[=INT] album to download
|
|
-t[=INT] --track[=INT] track to download (album id must be
|
|
specified)
|
|
-u[=STR] --url[=STR] download by URL
|
|
-d[=STR] --dir[=STR] download path (current direcotry will be
|
|
used by default)
|
|
--proxy STR HTTP-proxy (format: 1.2.3.4:8888)
|
|
--exclude STR skip tracks specified in file
|
|
--include STR download only tracks specified in file
|
|
--delay INT delay between downloads (in seconds)
|
|
--mobile INT use mobile API
|
|
--auth STR authorization header for mobile version
|
|
(OAuth...)
|
|
--cookie STR authorization cookie for web version
|
|
(Session_id=...)
|
|
--bitrate INT bitrate (eg. 64, 128, 192, 320)
|
|
--pattern STR track naming pattern
|
|
Available placeholders: #number, #artist,
|
|
#title
|
|
|
|
-l --link do not fetch, only print links to the
|
|
tracks
|
|
-s --silent do not print informational messages
|
|
--debug print debug info during work
|
|
--help print usage
|
|
|
|
--include and --exclude options use weak
|
|
match i.e. ~/$term/
|
|
|
|
Example:
|
|
ya.pl -p 123 -k ya-playlist
|
|
ya.pl -a 123
|
|
ya.pl -a 123 -t 321
|
|
ya.pl -u
|
|
https://music.yandex.ru/album/215690
|
|
ya.pl -u
|
|
https://music.yandex.ru/album/215688/track/1710808
|
|
ya.pl -u
|
|
https://music.yandex.ru/users/ya.playlist/playlists/1257
|
|
|
|
© 2013-2020 by Kaimi (https://kaimi.io)
|
|
```
|
|
|
|
## FAQ
|
|
### What is the cause for "[ERROR] Yandex.Music is not available"?
|
|
Currently Yandex Music is available only for Russia and CIS countries. For other countries you should either acquire paid subscription or use it through proxy (```--proxy``` parameter) from one of those countries. Thus it is possible to download from any country if you have an active Yandex.Music service subscription (https://music.yandex.ru/pay).
|
|
|
|
## Contribute
|
|
If you want to help make Yandex Music Downloader better the easiest thing you can do is to report issues and feature requests. Or you can help in development.
|
|
|
|
## License
|
|
Yandex Music Downloader Copyright © 2013-2021 by Kaimi (Sergey Belov) - https://kaimi.io.
|
|
|
|
Yandex Music Downloader is free software: you can redistribute it and/or modify it under the terms of the Massachusetts Institute of Technology (MIT) License.
|
|
|
|
You should have received a copy of the MIT License along with Yandex Music Downloader. If not, see [MIT License](LICENSE).
|