yandex-music-linux/README.md

yandex-music-linux

About

Native YandexMusic client for Linux. Built using repacking of Windows client (Electron app).

Table of content

• Screenshots
• Installation
  • Arch Linux
  • Debian/Ubuntu
  • RPM-based
• Configuration
  • Configuration file
  • Custom Electron binary
  • Electron arguments
  • Tray mode
• Manual Build
  • Prerequisites
  • Extract app only
  • ASAR archive
  • Arch Linux
  • Debian/Ubuntu
  • RPM-based
• Run with nix
  • Run with flakes
  • Run old style
  • Install to NixOS

Screenshots

Installation

Arch Linux

AUR

You can obtain the latest version of package from AUR using one of the AUR Helpers. Then install it with yandex-music as package name.

For this example I will use yay

yay -S yandex-music

Binary package file

Download prebuilt binary package from Releases section.

Then you can install it with the following command

pacman -U yandex-music-<version>-any.pkg.tar.zst

---

Debian/Ubuntu

APT

Package is currently unavailable at APT. If you'd like to help us with publishing, feel free to open new issue.

Binary package file

Download prebuilt binary package from Releases section.

Then you can install it with the following command

dpkg -i yandex-music_<version>_<arch>.deb

---

RPM-based

DNF

Package is currently unavailable at DNF. If you'd like to help us with publishing, feel free to open new issue.

Binary package file

Download prebuilt binary package from Releases section. Unfortunatelly, we only provide packages for x64 architecture. If you need package for different architecture, you can build it manually.

Then you can install it with the following command

rpm -i yandex-music-<version>-1.x86_64.rpm

---

Configuration

Configuration file

You can find configuration file at HOME/.config/yandex-music.conf. It's a simple key=value file that's sourced before launching the app. This means you can set environment variables and other options there.

---

Custom Electron binary

You can set path to custom Electron binary with ELECTRON_CUSTOM_BIN option. For example:

ELECTRON_CUSTOM_BIN=/usr/bin/electron

---

Electron arguments

You can set custom Electron flags with ELECTRON_ARGS option. By default it's set to --no-sandbox. For example:

ELECTRON_ARGS="--no-sandbox --trace-warnings"

---

Tray mode

Tray mode is disabled by default. It allows program to be minimized to tray instead of closing. To enable it set TRAY_ENABLED option to 1.

---

Manual Build

Prerequisites

That's the list of packages you might need to install to be able to manually build the app. However, you should remember that it might be different for your distro/machine.

- nodejs
- npm
- jq
- 7z (p7zip)
- unzip
- python

In addition you will need to install Asar tool with npm. I recommend install it globally with the following command

npm install -g @electron/asar

Last step is to download original client .exe file. You can get it yourself or take link to the latest version from ./utility/version_info.json file.

---

Extract app only

If you only want to get extracted app project with applied patches, you can use the following command:

bash repack.sh -x [-o OUTPUT_DIR default=./app] <YM.exe>

---

ASAR archive

.asar is archive file that containes all electron app resources and information, but doesn't hold Electron binaries. If you have .asar file you can launch app using electron <app>.asar. You can build this archive with the following command:

bash repack.sh [-o OUTPUT_DIR default=./app] <YM.exe>

---

Arch Linux

You can build pacman package file manually using PKGBUILD file from the this repository. Run following commands in folder with PKGBUILD file inside to get .pkg.tar.zst package:

pacman -S electron libpulse
makepkg

---

Debian/Ubuntu

You can build .deb binary package using the following command:

bash build_deb.sh  [-a <x64|armv7l|arm64|all> default=x64]

---

RPM-based

You can build .rpm binary package using the following command:

bash build_rpm.sh  [-a <x64|armv7l|arm64|all> default=x64]

Run with nix

The yandex-music package has unlicensed license, so you need to have allowUnfree option enabled.

Run with flakes

Execute next to build and run yandex music directly from github

nix run github:cucumber-sp/yandex-music-linux

Run old style

Execute next in this repository to build yandex-music package without using flakes.

nix-build --expr '(import <nixpkgs> {}).callPackage ./nix {}'

Install to NixOS

1. Add input in your flake.nix

   inputs = {
     yandex-music.url = "github:cucumber-sp/yandex-music-linux";
   };
   

2. Import module in your configuration.nix or home-manager.nix

   imports = [
     yandex-music.nixosModule
   ];
   

3. Add package yandex-music

   For configuration.nix:

   environment.systemPackages = with pkgs; [
     yandex-music
   ];
   

   For Home Manager:

   home.packages = with pkgs; [
     yandex-music
   ];