Yandex Music Downloader

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/.

Requirements

Environment

Linux/Windows/MacOS (anything, that runs Perl)
Perl >= 5.12

Perl modules

General
- Digest::MD5
- File::Copy
- File::Spec
- File::Temp
- File::Util
- 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

# 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

Nix / NixOS

nix shell github:kaimi-io/yandex-music-download
ya-music -h

MacOS

Install brew (https://brew.sh/).
Run:

brew update
brew install perl cpanminus git
cpanm Digest::MD5 File::Copy File::Spec File::Temp File::Util 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. Otherwise:

Download and install ActiveState Perl (https://www.activestate.com/products/perl/downloads/) or Strawberry Perl (http://strawberryperl.com/).
Ensure, that Perl was added to system PATH environment variable.
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.
Install required modules (it can be done via PPM if you're using ActiveState Perl):

cpan install Digest::MD5 File::Copy File::Spec File::Temp File::Util 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

Download and unpack Yandex Music Downloader (https://github.com/kaimi-io/yandex-music-download/archive/master.zip).
Run:

cd yandex-music-download/src
perl ya.pl -h

Docker

Install Docker (https://docs.docker.com/get-docker/).
Pull image from Docker Hub (https://hub.docker.com/r/ka1mi/yandex-music-downloader):

docker pull ka1mi/yandex-music-downloader:latest

Or build it:

git clone https://github.com/kaimi-io/yandex-music-download.git
cd yandex-music-download
docker build --tag yandex-music-downloader:1.0 .

Run:

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

Yandex Music Downloader v1.5

ya.pl [-adhklpstu] [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)
        --skip-existing            skip downloading tracks that already exist
                                   on the specified path
        --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
        --path STR                 path saving pattern

        Available placeholders: #number, #artist,
        #title, #album, #year

        Path pattern will be used in addition to
        the download path directory

        Example path pattern: #artist/#album-#year

        -l --link                  do not fetch, only print links to the
                                   tracks
        -s --silent                do not print informational messages
        --debug                    print debug info during work
        -h --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
        --cookie ...
        ya.pl -u
        https://music.yandex.ru/album/215688/track/1710808 --auth ...
        ya.pl -u
        https://music.yandex.ru/users/ya.playlist/playlists/1257 --cookie ...

        © 2013-2023 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 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.

kaimi-io / yandex-music-download