mirror of
https://github.com/cucumber-sp/yandex-music-linux.git
synced 2024-12-24 14:34:39 +03:00
196 lines
4.3 KiB
Markdown
196 lines
4.3 KiB
Markdown
# yandex-music-linux
|
|
|
|
## About
|
|
Native YandexMusic client for Linux. Built using repacking of Windows client (Electron app).
|
|
|
|
## Table of content
|
|
- [Screenshots](#screenshots)
|
|
- [Installation](#installation)
|
|
- [Arch Linux](#arch-linux)
|
|
- [Debian/Ubuntu](#debianubuntu)
|
|
- [Manual Build](#manual-build)
|
|
- [Prerequisites](#prerequisites)
|
|
- [Extract app only](#extract-app-only)
|
|
- [ASAR archive](#asar-archive)
|
|
- [Arch Linux](#arch-linux-1)
|
|
- [Debian/Ubuntu](#debianubuntu-1)
|
|
- [Run with nix](#run-with-nix)
|
|
- [Run with flakes](#run-with-flakes)
|
|
- [Run old style](#run-old-style)
|
|
- [Install to NixOS](#install-to-nixos)
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
### Arch Linux
|
|
|
|
***
|
|
|
|
#### AUR
|
|
|
|
You can obtain the latest version of package from `AUR` using one of the [AUR Helpers](https://wiki.archlinux.org/title/AUR_helpers). Then install it with `yandex-music` as package name.
|
|
|
|
For this example I will use [yay](https://github.com/Jguer/yay)
|
|
|
|
```bash
|
|
yay -S yandex-music
|
|
```
|
|
|
|
#### Binary package file
|
|
|
|
Download prebuilt binary package from [Releases](https://github.com/cucumber-sp/yandex-music-linux/releases) section.
|
|
|
|
Then you can install it with the following command
|
|
|
|
```bash
|
|
pacman -U yandex-music-<version>-any.pkg.tar.zst
|
|
```
|
|
|
|
***
|
|
|
|
### Debian/Ubuntu
|
|
|
|
***
|
|
|
|
#### APT
|
|
|
|
Package is currently unavailable at APT. We're still working on it
|
|
|
|
#### Binary package file
|
|
|
|
Download prebuilt binary package from [Releases](https://github.com/cucumber-sp/yandex-music-linux/releases) section.
|
|
|
|
Then you can install it with the following command
|
|
|
|
```bash
|
|
dpkg -i yandex-music_<version>_<arch>.deb
|
|
```
|
|
|
|
***
|
|
|
|
## 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](https://github.com/electron/asar) tool with `npm`. I recommend install it globally with the following command
|
|
|
|
```bash
|
|
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
|
|
sh 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
|
|
sh 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:
|
|
|
|
```bash
|
|
pacman -S electron libpulse
|
|
makepkg
|
|
```
|
|
|
|
***
|
|
|
|
### Debian/Ubuntu
|
|
|
|
You can build `.deb` binary package using the following command:
|
|
|
|
```bash
|
|
sh build_deb.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
|
|
|
|
```bash
|
|
nix run github:cucumber-sp/yandex-music-linux
|
|
```
|
|
|
|
### Run old style
|
|
|
|
Execute next in this repository to build yandex-music package without using
|
|
flakes.
|
|
|
|
```bash
|
|
nix-build --expr '(import <nixpkgs> {}).callPackage ./nix {}'
|
|
```
|
|
|
|
### Install to NixOS
|
|
|
|
1. Add input in your flake.nix
|
|
|
|
```nix
|
|
inputs = {
|
|
yandex-music.url = "github:cucumber-sp/yandex-music-linux";
|
|
};
|
|
```
|
|
|
|
2. Import module in your `configuration.nix` or `home-manager.nix`
|
|
|
|
```nix
|
|
imports = [
|
|
yandex-music.nixosModule
|
|
];
|
|
```
|
|
|
|
3. Add package `yandex-music`
|
|
|
|
For `configuration.nix`:
|
|
|
|
```nix
|
|
environment.systemPackages = with pkgs; [
|
|
yandex-music
|
|
];
|
|
```
|
|
For Home Manager:
|
|
|
|
```nix
|
|
home.packages = with pkgs; [
|
|
yandex-music
|
|
];
|
|
```
|