ymtui 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- ymtui-0.1.0/.gitignore +163 -0
- ymtui-0.1.0/LICENSE +21 -0
- ymtui-0.1.0/PKG-INFO +182 -0
- ymtui-0.1.0/README.md +151 -0
- ymtui-0.1.0/pyproject.toml +57 -0
- ymtui-0.1.0/ymtui/__init__.py +1 -0
- ymtui-0.1.0/ymtui/api/__init__.py +1 -0
- ymtui-0.1.0/ymtui/api/client.py +282 -0
- ymtui-0.1.0/ymtui/app.py +495 -0
- ymtui-0.1.0/ymtui/config.py +33 -0
- ymtui-0.1.0/ymtui/i18n.py +215 -0
- ymtui-0.1.0/ymtui/mpris.py +226 -0
- ymtui-0.1.0/ymtui/player.py +115 -0
- ymtui-0.1.0/ymtui/screens/__init__.py +1 -0
- ymtui-0.1.0/ymtui/screens/help_screen.py +25 -0
- ymtui-0.1.0/ymtui/screens/main_screen.py +406 -0
- ymtui-0.1.0/ymtui/state.py +44 -0
- ymtui-0.1.0/ymtui/styles/app.tcss +171 -0
- ymtui-0.1.0/ymtui/widgets/__init__.py +1 -0
- ymtui-0.1.0/ymtui/widgets/library.py +110 -0
- ymtui-0.1.0/ymtui/widgets/now_playing.py +153 -0
- ymtui-0.1.0/ymtui/widgets/search.py +30 -0
- ymtui-0.1.0/ymtui/widgets/tracklist.py +160 -0
ymtui-0.1.0/.gitignore
ADDED
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
# Byte-compiled / optimized / DLL files
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
*$py.class
|
|
5
|
+
|
|
6
|
+
# C extensions
|
|
7
|
+
*.so
|
|
8
|
+
|
|
9
|
+
# Distribution / packaging
|
|
10
|
+
.Python
|
|
11
|
+
build/
|
|
12
|
+
develop-eggs/
|
|
13
|
+
dist/
|
|
14
|
+
downloads/
|
|
15
|
+
eggs/
|
|
16
|
+
.eggs/
|
|
17
|
+
lib/
|
|
18
|
+
lib64/
|
|
19
|
+
parts/
|
|
20
|
+
sdist/
|
|
21
|
+
var/
|
|
22
|
+
wheels/
|
|
23
|
+
share/python-wheels/
|
|
24
|
+
*.egg-info/
|
|
25
|
+
.installed.cfg
|
|
26
|
+
*.egg
|
|
27
|
+
MANIFEST
|
|
28
|
+
|
|
29
|
+
# PyInstaller
|
|
30
|
+
# Usually these files are written by a python script from a template
|
|
31
|
+
# before PyInstaller builds the exe, so as to inject date/other infos into it.
|
|
32
|
+
*.manifest
|
|
33
|
+
*.spec
|
|
34
|
+
|
|
35
|
+
# Installer logs
|
|
36
|
+
pip-log.txt
|
|
37
|
+
pip-delete-this-directory.txt
|
|
38
|
+
|
|
39
|
+
# Unit test / coverage reports
|
|
40
|
+
htmlcov/
|
|
41
|
+
.tox/
|
|
42
|
+
.nox/
|
|
43
|
+
.coverage
|
|
44
|
+
.coverage.*
|
|
45
|
+
.cache
|
|
46
|
+
nosetests.xml
|
|
47
|
+
coverage.xml
|
|
48
|
+
*.cover
|
|
49
|
+
*.py,cover
|
|
50
|
+
.hypothesis/
|
|
51
|
+
.pytest_cache/
|
|
52
|
+
cover/
|
|
53
|
+
|
|
54
|
+
# Translations
|
|
55
|
+
*.mo
|
|
56
|
+
*.pot
|
|
57
|
+
|
|
58
|
+
# Django stuff:
|
|
59
|
+
*.log
|
|
60
|
+
local_settings.py
|
|
61
|
+
db.sqlite3
|
|
62
|
+
db.sqlite3-journal
|
|
63
|
+
|
|
64
|
+
# Flask stuff:
|
|
65
|
+
instance/
|
|
66
|
+
.webassets-cache
|
|
67
|
+
|
|
68
|
+
# Scrapy stuff:
|
|
69
|
+
.scrapy
|
|
70
|
+
|
|
71
|
+
# Sphinx documentation
|
|
72
|
+
docs/_build/
|
|
73
|
+
|
|
74
|
+
# PyBuilder
|
|
75
|
+
.pybuilder/
|
|
76
|
+
target/
|
|
77
|
+
|
|
78
|
+
# Jupyter Notebook
|
|
79
|
+
.ipynb_checkpoints
|
|
80
|
+
|
|
81
|
+
# IPython
|
|
82
|
+
profile_default/
|
|
83
|
+
ipython_config.py
|
|
84
|
+
|
|
85
|
+
# pyenv
|
|
86
|
+
# For a library or package, you might want to ignore these files since the code is
|
|
87
|
+
# intended to run in multiple environments; otherwise, check them in:
|
|
88
|
+
# .python-version
|
|
89
|
+
|
|
90
|
+
# pipenv
|
|
91
|
+
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
|
|
92
|
+
# However, in case of collaboration, if having platform-specific dependencies or dependencies
|
|
93
|
+
# having no cross-platform support, pipenv may install dependencies that don't work, or not
|
|
94
|
+
# install all needed dependencies.
|
|
95
|
+
#Pipfile.lock
|
|
96
|
+
|
|
97
|
+
# poetry
|
|
98
|
+
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
|
|
99
|
+
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
|
100
|
+
# commonly ignored for libraries.
|
|
101
|
+
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
|
|
102
|
+
#poetry.lock
|
|
103
|
+
|
|
104
|
+
# pdm
|
|
105
|
+
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
|
|
106
|
+
#pdm.lock
|
|
107
|
+
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
|
|
108
|
+
# in version control.
|
|
109
|
+
# https://pdm.fming.dev/#use-with-ide
|
|
110
|
+
.pdm.toml
|
|
111
|
+
|
|
112
|
+
# claude
|
|
113
|
+
.claude
|
|
114
|
+
|
|
115
|
+
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
|
|
116
|
+
__pypackages__/
|
|
117
|
+
|
|
118
|
+
# Celery stuff
|
|
119
|
+
celerybeat-schedule
|
|
120
|
+
celerybeat.pid
|
|
121
|
+
|
|
122
|
+
# SageMath parsed files
|
|
123
|
+
*.sage.py
|
|
124
|
+
|
|
125
|
+
# Environments
|
|
126
|
+
.env
|
|
127
|
+
.venv
|
|
128
|
+
env/
|
|
129
|
+
venv/
|
|
130
|
+
ENV/
|
|
131
|
+
env.bak/
|
|
132
|
+
venv.bak/
|
|
133
|
+
|
|
134
|
+
# Spyder project settings
|
|
135
|
+
.spyderproject
|
|
136
|
+
.spyproject
|
|
137
|
+
|
|
138
|
+
# Rope project settings
|
|
139
|
+
.ropeproject
|
|
140
|
+
|
|
141
|
+
# mkdocs documentation
|
|
142
|
+
/site
|
|
143
|
+
|
|
144
|
+
# mypy
|
|
145
|
+
.mypy_cache/
|
|
146
|
+
.dmypy.json
|
|
147
|
+
dmypy.json
|
|
148
|
+
|
|
149
|
+
# Pyre type checker
|
|
150
|
+
.pyre/
|
|
151
|
+
|
|
152
|
+
# pytype static type analyzer
|
|
153
|
+
.pytype/
|
|
154
|
+
|
|
155
|
+
# Cython debug symbols
|
|
156
|
+
cython_debug/
|
|
157
|
+
|
|
158
|
+
# PyCharm
|
|
159
|
+
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
|
|
160
|
+
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
|
|
161
|
+
# and can be added to the global gitignore or merged into this file. For a more nuclear
|
|
162
|
+
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
|
|
163
|
+
#.idea/
|
ymtui-0.1.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Sergey Ovechkin
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
ymtui-0.1.0/PKG-INFO
ADDED
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: ymtui
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Консольный плеер Яндекс Музыки
|
|
5
|
+
Project-URL: Homepage, https://github.com/pomeo/ymtui
|
|
6
|
+
Project-URL: Repository, https://github.com/pomeo/ymtui
|
|
7
|
+
Project-URL: Issues, https://github.com/pomeo/ymtui/issues
|
|
8
|
+
Author-email: Sergey Ovechkin <pomeo@pomeo.ru>
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: console,mpris,music,player,terminal,textual,tui,yandex,yandex-music
|
|
12
|
+
Classifier: Development Status :: 4 - Beta
|
|
13
|
+
Classifier: Environment :: Console
|
|
14
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
15
|
+
Classifier: Natural Language :: Russian
|
|
16
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
22
|
+
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
|
|
23
|
+
Classifier: Topic :: Terminals
|
|
24
|
+
Requires-Python: >=3.10
|
|
25
|
+
Requires-Dist: python-mpv>=1.0.0
|
|
26
|
+
Requires-Dist: textual>=8.2.5
|
|
27
|
+
Requires-Dist: yandex-music>=3.0.0
|
|
28
|
+
Provides-Extra: mpris
|
|
29
|
+
Requires-Dist: mpris-server>=1.0.0; extra == 'mpris'
|
|
30
|
+
Description-Content-Type: text/markdown
|
|
31
|
+
|
|
32
|
+
# ymtui
|
|
33
|
+
|
|
34
|
+
> Консольный плеер **Яндекс Музыки**.
|
|
35
|
+
|
|
36
|
+
[](https://pypi.org/project/ymtui/)
|
|
37
|
+
[](https://pypi.org/project/ymtui/)
|
|
38
|
+
[](LICENSE)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
`ymtui` — это терминальный плеер для Яндекс Музыки на [Textual](https://textual.textualize.io/)
|
|
43
|
+
|
|
44
|
+
## Возможности
|
|
45
|
+
|
|
46
|
+
- 🌊 **Моя волна** — бесконечное персональное радио с подгрузкой и подстройкой
|
|
47
|
+
- ❤️ **Любимое**, 🏆 **Чарт**, 🕘 **История** прослушивания
|
|
48
|
+
- ⭐ **Плейлисты дня** (Дежавю, Премьера, Плейлист дня…) из персональной ленты
|
|
49
|
+
- ✨ **Новые плейлисты** и 💿 **Новинки** (альбомы)
|
|
50
|
+
- 🎼 **Жанры / Настроения / Занятия / Эпохи** — навигация по подборкам
|
|
51
|
+
- 📂 **Мои плейлисты**
|
|
52
|
+
- 🔎 Поиск треков
|
|
53
|
+
- ⏯ Воспроизведение, перемотка (клавишами и кликом по полосе), 🔀 шафл, 🔁 повтор, лайки
|
|
54
|
+
- 💾 **Сохранение сессии**: при следующем запуске откроется тот же раздел/плейлист,
|
|
55
|
+
а последний трек подгрузится на сохранённой позиции
|
|
56
|
+
- 🎨 Темы и 🌐 **языки интерфейса** (русский / английский), всё сохраняется
|
|
57
|
+
- 🎛 **MPRIS**: управление мультимедиа-клавишами и через `playerctl`
|
|
58
|
+
|
|
59
|
+
## Установка
|
|
60
|
+
|
|
61
|
+
### 1. Системные зависимости
|
|
62
|
+
|
|
63
|
+
Для воспроизведения нужен **libmpv**:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# Debian / Ubuntu
|
|
67
|
+
sudo apt install libmpv2 # на старых релизах: libmpv1
|
|
68
|
+
|
|
69
|
+
# Fedora
|
|
70
|
+
sudo dnf install mpv-libs
|
|
71
|
+
|
|
72
|
+
# Arch
|
|
73
|
+
sudo pacman -S mpv
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### 2. Установка ymtui
|
|
77
|
+
|
|
78
|
+
Рекомендуемый способ — [pipx](https://pipx.pypa.io/) (изолированно) или
|
|
79
|
+
[uv](https://docs.astral.sh/uv/):
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
pipx install ymtui
|
|
83
|
+
# или
|
|
84
|
+
uv tool install ymtui
|
|
85
|
+
# или
|
|
86
|
+
pip install --user ymtui
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### 3. (Опционально) Медиа-клавиши и playerctl
|
|
90
|
+
|
|
91
|
+
Поддержка MPRIS вынесена в отдельную зависимость, т.к. требует системных
|
|
92
|
+
библиотек GObject. Если нужны мультимедиа-клавиши / `playerctl`:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# Debian / Ubuntu — заголовки для сборки PyGObject
|
|
96
|
+
sudo apt install libgirepository1.0-dev gir1.2-glib-2.0 gcc pkg-config python3-dev
|
|
97
|
+
|
|
98
|
+
pipx install "ymtui[mpris]" # или uv tool install "ymtui[mpris]"
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Без этого приложение работает полностью — просто без медиа-клавиш.
|
|
102
|
+
|
|
103
|
+
## Первый запуск
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
ymtui
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
При первом запуске пройдёт авторизация через **OAuth Device Flow**: в терминале
|
|
110
|
+
появится ссылка и код — откройте ссылку, введите код, и токен сохранится в
|
|
111
|
+
`~/.config/ymtui/config.ini`. Повторно авторизовываться не нужно.
|
|
112
|
+
Если получение токена для вашего аккаунта не работает — смотрите [альтернативные способы](https://ym.marshal.dev/token/#implicit-oauth).
|
|
113
|
+
|
|
114
|
+
> Уже есть токен? Можно вписать его вручную:
|
|
115
|
+
> ```ini
|
|
116
|
+
> [ymtui]
|
|
117
|
+
> token = y0_AgAEA...
|
|
118
|
+
> ```
|
|
119
|
+
|
|
120
|
+
## Управление
|
|
121
|
+
|
|
122
|
+
| Клавиша | Действие |
|
|
123
|
+
|---|---|
|
|
124
|
+
| `space` | играть / пауза |
|
|
125
|
+
| `enter` | играть выбранный трек |
|
|
126
|
+
| `n` / `p` | следующий / предыдущий |
|
|
127
|
+
| `< ` / `>` (или `,` / `.`) | перемотка −5с / +5с |
|
|
128
|
+
| клик по полосе | перемотка на позицию |
|
|
129
|
+
| `l` | лайк / снять лайк |
|
|
130
|
+
| `s` | перемешать |
|
|
131
|
+
| `r` | повтор |
|
|
132
|
+
| `+` / `-` | громче / тише |
|
|
133
|
+
| `tab` / `shift+tab` | переключение панелей |
|
|
134
|
+
| `↑` / `↓` | движение по списку |
|
|
135
|
+
| `/` | поиск |
|
|
136
|
+
| `?` | справка |
|
|
137
|
+
| `ctrl+p` | настройки (тема, язык, скриншот…) |
|
|
138
|
+
| `q` | выход |
|
|
139
|
+
|
|
140
|
+
## Темы и язык
|
|
141
|
+
|
|
142
|
+
Нажмите `Ctrl+P` (настройки) → можно сменить **тему** оформления и **язык**
|
|
143
|
+
интерфейса (русский / английский). Выбор сохраняется и применяется сразу,
|
|
144
|
+
без перезапуска.
|
|
145
|
+
|
|
146
|
+
## Медиа-клавиши (MPRIS / playerctl)
|
|
147
|
+
|
|
148
|
+
С установленным extra `[mpris]` плеер виден как `ymtui`:
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
playerctl -p ymtui play-pause
|
|
152
|
+
playerctl -p ymtui next
|
|
153
|
+
playerctl -p ymtui metadata --format '{{artist}} — {{title}}'
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
Можно запускать несколько копий: первая занимает имя `ymtui`, остальные —
|
|
157
|
+
`ymtui.instance<PID>`.
|
|
158
|
+
|
|
159
|
+
## Конфигурация и данные
|
|
160
|
+
|
|
161
|
+
Всё хранится в `~/.config/ymtui/`:
|
|
162
|
+
|
|
163
|
+
- `config.ini` — токен авторизации;
|
|
164
|
+
- `state.json` — последняя сессия (раздел, трек, позиция, тема, язык).
|
|
165
|
+
|
|
166
|
+
## Разработка
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
git clone https://github.com/pomeo/ymtui
|
|
170
|
+
cd ymtui
|
|
171
|
+
uv sync # или: pip install -e ".[mpris]"
|
|
172
|
+
python main.py
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## Лицензия
|
|
176
|
+
|
|
177
|
+
[MIT](LICENSE) © Sergey Ovechkin
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
Проект не является официальным продуктом Яндекса. Используйте с собственным
|
|
182
|
+
аккаунтом Яндекс Музыки.
|
ymtui-0.1.0/README.md
ADDED
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
# ymtui
|
|
2
|
+
|
|
3
|
+
> Консольный плеер **Яндекс Музыки**.
|
|
4
|
+
|
|
5
|
+
[](https://pypi.org/project/ymtui/)
|
|
6
|
+
[](https://pypi.org/project/ymtui/)
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
`ymtui` — это терминальный плеер для Яндекс Музыки на [Textual](https://textual.textualize.io/)
|
|
12
|
+
|
|
13
|
+
## Возможности
|
|
14
|
+
|
|
15
|
+
- 🌊 **Моя волна** — бесконечное персональное радио с подгрузкой и подстройкой
|
|
16
|
+
- ❤️ **Любимое**, 🏆 **Чарт**, 🕘 **История** прослушивания
|
|
17
|
+
- ⭐ **Плейлисты дня** (Дежавю, Премьера, Плейлист дня…) из персональной ленты
|
|
18
|
+
- ✨ **Новые плейлисты** и 💿 **Новинки** (альбомы)
|
|
19
|
+
- 🎼 **Жанры / Настроения / Занятия / Эпохи** — навигация по подборкам
|
|
20
|
+
- 📂 **Мои плейлисты**
|
|
21
|
+
- 🔎 Поиск треков
|
|
22
|
+
- ⏯ Воспроизведение, перемотка (клавишами и кликом по полосе), 🔀 шафл, 🔁 повтор, лайки
|
|
23
|
+
- 💾 **Сохранение сессии**: при следующем запуске откроется тот же раздел/плейлист,
|
|
24
|
+
а последний трек подгрузится на сохранённой позиции
|
|
25
|
+
- 🎨 Темы и 🌐 **языки интерфейса** (русский / английский), всё сохраняется
|
|
26
|
+
- 🎛 **MPRIS**: управление мультимедиа-клавишами и через `playerctl`
|
|
27
|
+
|
|
28
|
+
## Установка
|
|
29
|
+
|
|
30
|
+
### 1. Системные зависимости
|
|
31
|
+
|
|
32
|
+
Для воспроизведения нужен **libmpv**:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
# Debian / Ubuntu
|
|
36
|
+
sudo apt install libmpv2 # на старых релизах: libmpv1
|
|
37
|
+
|
|
38
|
+
# Fedora
|
|
39
|
+
sudo dnf install mpv-libs
|
|
40
|
+
|
|
41
|
+
# Arch
|
|
42
|
+
sudo pacman -S mpv
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### 2. Установка ymtui
|
|
46
|
+
|
|
47
|
+
Рекомендуемый способ — [pipx](https://pipx.pypa.io/) (изолированно) или
|
|
48
|
+
[uv](https://docs.astral.sh/uv/):
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
pipx install ymtui
|
|
52
|
+
# или
|
|
53
|
+
uv tool install ymtui
|
|
54
|
+
# или
|
|
55
|
+
pip install --user ymtui
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### 3. (Опционально) Медиа-клавиши и playerctl
|
|
59
|
+
|
|
60
|
+
Поддержка MPRIS вынесена в отдельную зависимость, т.к. требует системных
|
|
61
|
+
библиотек GObject. Если нужны мультимедиа-клавиши / `playerctl`:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
# Debian / Ubuntu — заголовки для сборки PyGObject
|
|
65
|
+
sudo apt install libgirepository1.0-dev gir1.2-glib-2.0 gcc pkg-config python3-dev
|
|
66
|
+
|
|
67
|
+
pipx install "ymtui[mpris]" # или uv tool install "ymtui[mpris]"
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Без этого приложение работает полностью — просто без медиа-клавиш.
|
|
71
|
+
|
|
72
|
+
## Первый запуск
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
ymtui
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
При первом запуске пройдёт авторизация через **OAuth Device Flow**: в терминале
|
|
79
|
+
появится ссылка и код — откройте ссылку, введите код, и токен сохранится в
|
|
80
|
+
`~/.config/ymtui/config.ini`. Повторно авторизовываться не нужно.
|
|
81
|
+
Если получение токена для вашего аккаунта не работает — смотрите [альтернативные способы](https://ym.marshal.dev/token/#implicit-oauth).
|
|
82
|
+
|
|
83
|
+
> Уже есть токен? Можно вписать его вручную:
|
|
84
|
+
> ```ini
|
|
85
|
+
> [ymtui]
|
|
86
|
+
> token = y0_AgAEA...
|
|
87
|
+
> ```
|
|
88
|
+
|
|
89
|
+
## Управление
|
|
90
|
+
|
|
91
|
+
| Клавиша | Действие |
|
|
92
|
+
|---|---|
|
|
93
|
+
| `space` | играть / пауза |
|
|
94
|
+
| `enter` | играть выбранный трек |
|
|
95
|
+
| `n` / `p` | следующий / предыдущий |
|
|
96
|
+
| `< ` / `>` (или `,` / `.`) | перемотка −5с / +5с |
|
|
97
|
+
| клик по полосе | перемотка на позицию |
|
|
98
|
+
| `l` | лайк / снять лайк |
|
|
99
|
+
| `s` | перемешать |
|
|
100
|
+
| `r` | повтор |
|
|
101
|
+
| `+` / `-` | громче / тише |
|
|
102
|
+
| `tab` / `shift+tab` | переключение панелей |
|
|
103
|
+
| `↑` / `↓` | движение по списку |
|
|
104
|
+
| `/` | поиск |
|
|
105
|
+
| `?` | справка |
|
|
106
|
+
| `ctrl+p` | настройки (тема, язык, скриншот…) |
|
|
107
|
+
| `q` | выход |
|
|
108
|
+
|
|
109
|
+
## Темы и язык
|
|
110
|
+
|
|
111
|
+
Нажмите `Ctrl+P` (настройки) → можно сменить **тему** оформления и **язык**
|
|
112
|
+
интерфейса (русский / английский). Выбор сохраняется и применяется сразу,
|
|
113
|
+
без перезапуска.
|
|
114
|
+
|
|
115
|
+
## Медиа-клавиши (MPRIS / playerctl)
|
|
116
|
+
|
|
117
|
+
С установленным extra `[mpris]` плеер виден как `ymtui`:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
playerctl -p ymtui play-pause
|
|
121
|
+
playerctl -p ymtui next
|
|
122
|
+
playerctl -p ymtui metadata --format '{{artist}} — {{title}}'
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Можно запускать несколько копий: первая занимает имя `ymtui`, остальные —
|
|
126
|
+
`ymtui.instance<PID>`.
|
|
127
|
+
|
|
128
|
+
## Конфигурация и данные
|
|
129
|
+
|
|
130
|
+
Всё хранится в `~/.config/ymtui/`:
|
|
131
|
+
|
|
132
|
+
- `config.ini` — токен авторизации;
|
|
133
|
+
- `state.json` — последняя сессия (раздел, трек, позиция, тема, язык).
|
|
134
|
+
|
|
135
|
+
## Разработка
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
git clone https://github.com/pomeo/ymtui
|
|
139
|
+
cd ymtui
|
|
140
|
+
uv sync # или: pip install -e ".[mpris]"
|
|
141
|
+
python main.py
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## Лицензия
|
|
145
|
+
|
|
146
|
+
[MIT](LICENSE) © Sergey Ovechkin
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
Проект не является официальным продуктом Яндекса. Используйте с собственным
|
|
151
|
+
аккаунтом Яндекс Музыки.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "ymtui"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "Консольный плеер Яндекс Музыки"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.10"
|
|
7
|
+
license = "MIT"
|
|
8
|
+
license-files = ["LICENSE"]
|
|
9
|
+
authors = [
|
|
10
|
+
{ name = "Sergey Ovechkin", email = "pomeo@pomeo.ru" },
|
|
11
|
+
]
|
|
12
|
+
keywords = [
|
|
13
|
+
"yandex-music", "yandex", "music", "player",
|
|
14
|
+
"tui", "terminal", "console", "textual", "mpris",
|
|
15
|
+
]
|
|
16
|
+
classifiers = [
|
|
17
|
+
"Development Status :: 4 - Beta",
|
|
18
|
+
"Environment :: Console",
|
|
19
|
+
"Intended Audience :: End Users/Desktop",
|
|
20
|
+
"Operating System :: POSIX :: Linux",
|
|
21
|
+
"Programming Language :: Python :: 3",
|
|
22
|
+
"Programming Language :: Python :: 3.10",
|
|
23
|
+
"Programming Language :: Python :: 3.11",
|
|
24
|
+
"Programming Language :: Python :: 3.12",
|
|
25
|
+
"Programming Language :: Python :: 3.13",
|
|
26
|
+
"Topic :: Multimedia :: Sound/Audio :: Players",
|
|
27
|
+
"Topic :: Terminals",
|
|
28
|
+
"Natural Language :: Russian",
|
|
29
|
+
]
|
|
30
|
+
dependencies = [
|
|
31
|
+
"textual>=8.2.5",
|
|
32
|
+
"yandex-music>=3.0.0",
|
|
33
|
+
"python-mpv>=1.0.0",
|
|
34
|
+
]
|
|
35
|
+
|
|
36
|
+
# MPRIS (медиа-клавиши) тянет PyGObject, которому нужны системные
|
|
37
|
+
# заголовки — поэтому вынесено в опциональную зависимость.
|
|
38
|
+
[project.optional-dependencies]
|
|
39
|
+
mpris = ["mpris-server>=1.0.0"]
|
|
40
|
+
|
|
41
|
+
[project.urls]
|
|
42
|
+
Homepage = "https://github.com/pomeo/ymtui"
|
|
43
|
+
Repository = "https://github.com/pomeo/ymtui"
|
|
44
|
+
Issues = "https://github.com/pomeo/ymtui/issues"
|
|
45
|
+
|
|
46
|
+
[project.scripts]
|
|
47
|
+
ymtui = "ymtui.app:main"
|
|
48
|
+
|
|
49
|
+
[build-system]
|
|
50
|
+
requires = ["hatchling"]
|
|
51
|
+
build-backend = "hatchling.build"
|
|
52
|
+
|
|
53
|
+
[tool.hatch.build.targets.wheel]
|
|
54
|
+
packages = ["ymtui"]
|
|
55
|
+
|
|
56
|
+
[tool.hatch.build.targets.sdist]
|
|
57
|
+
include = ["ymtui", "README.md", "LICENSE"]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Yandex Music console player."""
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Yandex Music API package."""
|