0
0
mirror of https://github.com/cucumber-sp/yandex-music-linux.git synced 2024-12-23 14:12:59 +03:00

Update README.md

This commit is contained in:
Andrey Onishchenko 2024-02-05 17:12:29 +03:00 committed by GitHub
parent 852cd6a5ba
commit 22141fd0cd
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 131 additions and 23 deletions

131
README.md Normal file
View File

@ -0,0 +1,131 @@
# 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)
## Screenshots
![image](https://github.com/cucumber-sp/yandex-music-linux/assets/100789522/ab2f69ee-efc4-4a33-8110-131b4c4ff4de)
![image](https://github.com/cucumber-sp/yandex-music-linux/assets/100789522/de618654-15d1-4103-a323-faa00086d0a2)
## 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 `yandexmusic` as package name.
For this example I will use [yay](https://github.com/Jguer/yay)
```
yay -S yandexmusic
```
#### 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
```
pacman -U yandexmusic-<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
```
dpkg -i yandexmusic_<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
```
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
```
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 `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:
```
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:
```
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:
```
pacman -S electron libpulse
makepkg
```
***
### Debian/Ubuntu
You can build `.deb` binary package using the following command:
```
sh build_deb.sh [-a <x64|armv7l|arm64|all> default=x64]
```

View File

@ -1,23 +0,0 @@
# yandex-music-linux
Нативный клиент Яндекс Музыки для Linux. Создан с помощью перепаковки бета-версии клиента для OSX/Windows.
Native Yandex Music client for Linux. Made with OSX/Windows beta client repacking.
## Скриншоты/Screenshots
![image](https://github.com/cucumber-sp/yandex-music-linux/assets/100789522/ab2f69ee-efc4-4a33-8110-131b4c4ff4de)
![image](https://github.com/cucumber-sp/yandex-music-linux/assets/100789522/de618654-15d1-4103-a323-faa00086d0a2)
## Установка/Install
Доступные архитектуры: x64, arm64. Установка возможна с помощью deb и rpm пакетов или распаковкой архива. Актуальная версия клиента доступна в https://github.com/cucumber-sp/yandex-music-linux/releases
Available architectures: x64, arm64
You can install this app with dep and rpm packages, or by extracting archive file. Actual version is available at https://github.com/cucumber-sp/yandex-music-linux/releases
## Самостоятельная сборка
Скачайте файл `repack.sh` и .exe файл клиента. Запустите скрипт с помощью `bash repack.sh <path_to_exe>`. В процессе выберите сборку для нужных архитектур (x64, arm64). Зависимости которые могут понадобиться: `nodejs`, `jq`, `npm`, `7z`, `npm asar`, `rpm-tools`
## NixOs
Запустите `nix run` в корне этого репозитория, чтобы запустить приложение. Так
же вы можете использовать поле `modules` из flake этого репозитория. Добавив его
в модули вашей системы, вы получите пакет `yandex-music` в коллекции pkgs.