Команда yay -S yandex-music на Arch Linux нередко завершается ошибкой сборки или конфликтом зависимостей Electron — это типичная ситуация, потому что официального нативного клиента Яндекс Музыки для Linux не существует, а все доступные варианты построены на неофициальных обёртках. Из-за этого установка требует понимания того, какой именно пакет вы ставите и откуда он берётся.
В этой статье разберём рабочие способы запустить Яндекс Музыку на Arch Linux: через AUR-клиенты, веб-версию в браузере и альтернативные решения. Отдельно рассмотрим типичные ошибки — от конфликтов версий Electron до отсутствия звука через PipeWire — и способы их диагностики.
Какие варианты установки существуют
Поскольку официального Linux-клиента нет, выбор сводится к нескольким неофициальным решениям. Каждое имеет свои ограничения, и важно понимать их до установки.
- 🎵 Yandex Music Desktop (AUR) — неофициальная Electron-обёртка веб-версии, самый популярный вариант в Arch-сообществе.
- 🌐 Веб-версия — music.yandex.ru в любом браузере, работает без установки, но без системных медиа-клавиш из коробки.
- 📦 Flatpak-сборки — изолированные пакеты, ставятся независимо от системных библиотек.
- 🖥️ PWA-приложение — установка сайта как отдельного окна через Chromium или Chrome.
Точный состав пакетов в AUR меняется со временем: сопровождающие могут забросить пакет или переименовать его. Перед установкой проверьте актуальность пакета на странице AUR — дату последнего обновления и комментарии пользователей.
Установка через AUR
Стандартный путь для Arch — установка из AUR через помощник вроде yay или paru. Если помощник ещё не установлен, сначала настройте его, следуя официальной вики Arch.
yay -S yandex-musicВо время установки обратите внимание на вывод: помощник покажет PKGBUILD и спросит подтверждение. Хорошая практика — просматривать PKGBUILD перед сборкой, чтобы убедиться, что пакет скачивает клиент с ожидаемого источника.
☑️ Установка Яндекс Музыки из AUR
⚠️ Внимание: пакеты из AUR поддерживаются сообществом, а не Яндексом и не разработчиками Arch. Возможны задержки обновлений, поломки после апстрим-изменений и заброшенные пакеты. Всегда читайте комментарии на странице пакета перед установкой.
После установки клиент появится в меню приложений. Запуск из терминала командой yandex-music полезен при диагностике — все ошибки будут видны в выводе.
Веб-версия и PWA как альтернатива
Если AUR-клиент не собирается или вызывает сомнения, веб-версия остаётся полностью рабочим вариантом. Откройте music.yandex.ru в Firefox или Chromium — воспроизведение, плейлисты и подборки работают без ограничений со стороны браузера.
Для более «десктопного» опыта установите сайт как PWA. В Chromium-based браузерах это делается через меню: пункт вроде «Установить приложение» или «Создать ярлык» с открытием в отдельном окне. Точное название пункта зависит от версии браузера.
Минус веб-варианта — зависимость от браузера и отсутствие трей-иконки. Плюс — никаких конфликтов зависимостей и всегда актуальная версия интерфейса.
Сравнение способов установки
| Способ | Сложность | Медиа-клавиши | Риски |
|---|---|---|---|
| AUR-клиент | Средняя | Обычно из коробки | Поломки при обновлениях |
| Веб-версия | Минимальная | Требует настройки браузера | Практически нет |
| PWA | Низкая | Через браузер | Минимальные |
| Flatpak | Низкая | Зависит от сборки | Изоляция может ломать интеграции |
Типичные ошибки и их решение
Самая частая проблема — конфликт версий Electron. Неофициальные клиенты часто жёстко привязаны к конкретной версии Electron, и после системного обновления клиент перестаёт запускаться с ошибкой вроде «electron: not found» или падением при старте.
Диагностика проста: запустите клиент из терминала и прочитайте вывод. Если ошибка указывает на отсутствующую библиотеку или версию Electron, установите нужную версию пакета (electron, electron28 и т.п. — точное имя смотрите в зависимостях PKGBUILD) или дождитесь обновления пакета в AUR.
⚠️ Внимание: не откатывайте системные пакеты Electron принудительно ради одного приложения — это может сломать другие программы. Безопаснее установить параллельно нужную версию пакета, если она доступна в репозиториях.
Вторая типичная жалоба — нет звука. На Arch чаще всего звуковой сервер — PipeWire или PulseAudio. Проверьте, что сервис запущен: systemctl --user status pipewire. Если звук есть в браузере, но нет в клиенте, проблема обычно в sandbox-настройках Electron-приложения.
Подробнее про диагностику звука
Проверьте вывод команды pactl list sinks short — должны быть видны активные устройства вывода. Откройте pavucontrol во время воспроизведения и убедитесь, что поток клиента направлен на нужное устройство и не приглушён. Если клиента нет в списке потоков, он не смог подключиться к звуковому серверу — попробуйте запуск с флагом --no-sandbox для проверки (только в диагностических целях).
Настройка горячих клавиш и интеграция с системой
Electron-клиенты обычно поддерживают стандарт MPRIS, что позволяет управлять воспроизведением через медиа-клавиши и виджеты рабочего окружения. Проверить, видит ли система плеер, можно командой playerctl -l — клиент должен появиться в списке.
Если горячие клавиши не работают, привяжите их вручную в настройках вашего окружения (KDE, GNOME, i3) к командам playerctl play-pause, playerctl next и playerctl previous. Этот способ универсален и не зависит от конкретного клиента.
bindsym XF86AudioPlay exec playerctl play-pause
bindsym XF86AudioNext exec playerctl next
Пример выше актуален для i3/sway; в KDE и GNOME привязка делается через графические настройки клавиатуры.
Обновление и обслуживание клиента
При pacman -Syu AUR-пакеты не обновляются автоматически — за это отвечает ваш AUR-помощник. Периодически выполняйте yay -Sua, чтобы подтягивать обновления только из AUR.
Если после обновления клиент сломался, не спешите удалять его: проверьте страницу пакета в AUR — часто решение уже описано в комментариях, либо сопровождающий выпускает исправление в течение нескольких дней. На это время веб-версия закроет потребность в музыке.
Держите под рукой веб-версию как запасной вариант — это единственный способ доступа к Яндекс Музыке, который не зависит от состояния неофициальных пакетов.
Часто задаваемые вопросы
Есть ли официальный клиент Яндекс Музыки для Linux?
Нет, официального нативного клиента для Linux Яндекс не выпускает. Все десктопные варианты — неофициальные обёртки веб-версии, поддерживаемые сообществом.
Клиент из AUR не собирается, что делать?
Сначала обновите систему целиком (pacman -Syu) — частичные обновления частая причина ошибок сборки. Затем прочитайте комментарии на странице пакета в AUR: там обычно есть решение или информация о поломке. Как временная мера — используйте веб-версию.
Работают ли медиа-клавиши с веб-версией?
Да, если браузер передаёт их системе. В Chromium проверьте флаг Hardware Media Key Handling, в Firefox поддержка обычно работает по умолчанию. Универсальный запасной вариант — playerctl с ручной привязкой клавиш.
Безопасно ли ставить неофициальный клиент из AUR?
AUR — пользовательский репозиторий без гарантий проверки. Просматривайте PKGBUILD перед сборкой, проверяйте источник загрузки и популярность пакета. Это базовая гигиена для любых пакетов из AUR, не только для музыкальных клиентов.
Клиент запускается, но окно чёрное или пустое. В чём причина?
Возможная причина — проблемы с GPU-ускорением в Electron. Попробуйте запуск с отключённым аппаратным ускорением (флаг --disable-gpu) для проверки. Если помогло, ищите обновление пакета или драйверов видеокарты.