ymtui

Консольный плеер Яндекс Музыки.

ymtui — это терминальный плеер для Яндекс Музыки на Textual

Возможности

• 🌊 Моя волна — бесконечное персональное радио с подгрузкой и подстройкой, а также волны под занятие / настроение / жанр / эпоху (Бег, Просыпаюсь, Грустное…) — выберите «Моя волна» и загляните в нижний блок
• ❤️ Любимое, 🏆 Чарт, 🕘 История прослушивания
• ⭐ Плейлисты дня (Дежавю, Премьера, Плейлист дня…) из персональной ленты
• ✨ Новые плейлисты и 💿 Новинки (альбомы)
• 🎼 Жанры / Настроения / Занятия / Эпохи — навигация по подборкам
• 📂 Мои плейлисты
• 🔎 Поиск треков
• ⏯ Воспроизведение, перемотка (клавишами и кликом по полосе), 🔀 шафл, 🔁 повтор, лайки
• 💾 Сохранение сессии: при следующем запуске откроется тот же раздел/плейлист, а последний трек подгрузится на сохранённой позиции
• 🎨 Темы и 🌐 языки интерфейса (русский / английский), всё сохраняется
• 🖼 Обложка альбома в плеере (опционально, включается в Ctrl+P)
• 🎛 MPRIS: управление мультимедиа-клавишами и через playerctl (с обложкой)

Установка

1. Системные зависимости

Для воспроизведения нужен libmpv:

# Debian / Ubuntu
sudo apt install libmpv2        # на старых релизах: libmpv1

# Fedora
sudo dnf install mpv-libs

# Arch
sudo pacman -S mpv

2. Установка ymtui

Рекомендуемый способ — pipx (изолированно) или uv:

pipx install ymtui
# или
uv tool install ymtui
# или
pip install --user ymtui

3. (Опционально) Медиа-клавиши и playerctl

Поддержка MPRIS вынесена в отдельную зависимость, т.к. требует системных библиотек GObject. Если нужны мультимедиа-клавиши / playerctl:

# Debian / Ubuntu — заголовки для сборки PyGObject
sudo apt install libgirepository-2.0-dev gir1.2-glib-2.0 gcc pkg-config python3-dev

pipx install "ymtui[mpris]"     # или uv tool install "ymtui[mpris]"

Без этого приложение работает полностью — просто без медиа-клавиш.

4. (Опционально) Обложка альбома

Показ обложки в плеере (включается в Ctrl+P). Лучше всего смотрится в терминалах с графикой (kitty, WezTerm, iTerm2, foot), в остальных — фолбэк:

pipx install "ymtui[cover]"     # можно совмещать: ymtui[mpris,cover]

Первый запуск

ymtui

При первом запуске пройдёт авторизация через OAuth Device Flow: в терминале появится ссылка и код — откройте ссылку, введите код, и токен сохранится в ~/.config/ymtui/config.ini. Повторно авторизовываться не нужно. Если получение токена для вашего аккаунта не работает — смотрите альтернативные способы.

Уже есть токен? Можно вписать его вручную:

[ymtui]
token = y0_AgAEA...

Управление

Темы и язык

Нажмите Ctrl+P (настройки) → можно сменить тему оформления и язык интерфейса (русский / английский). Выбор сохраняется и применяется сразу, без перезапуска.

Медиа-клавиши (MPRIS / playerctl)

С установленным extra [mpris] плеер виден как ymtui:

playerctl -p ymtui play-pause
playerctl -p ymtui next
playerctl -p ymtui metadata --format '{{artist}} — {{title}}'

Можно запускать несколько копий: первая занимает имя ymtui, остальные — ymtui.instance<PID>.

Конфигурация и данные

Всё хранится в ~/.config/ymtui/:

• config.ini — токен авторизации;
• state.json — последняя сессия (раздел, трек, позиция, тема, язык).

Разработка

git clone https://github.com/pomeo/ymtui
cd ymtui
uv sync                 # или: pip install -e ".[mpris]"
python main.py

Лицензия

MIT © Sergey Ovechkin

Проект не является официальным продуктом Яндекса. Используйте с собственным аккаунтом Яндекс Музыки.