Files
buryan-infra/ops/media/MUSIC-TOOLS.md
T
buryan-agent 7e0afefbe1 Lidarr и beets: управление музыкой, теги, дубли
Lidarr 3.1.0 в CT 111 (192.168.1.240:8686): корневая папка /music,
qBittorrent с категорией lidarr, синхронизация индексаторов из Prowlarr.
Образ через ghcr.nju.edu.cn (lscr.io тянется слишком медленно), host-сеть
(-p не пробрасывал порт).

music_tools.py: --status, --import (beets), --enrich (MusicBrainz),
--dupes (fpcalc). Команда «музыка» показывает Navidrome, библиотеку, Lidarr
и наличие токена Яндекса.

Ловушки: адрес CT 111 — 192.168.1.240; f-string ломается на шаблоне beets
с фигурными скобками.
2026-10-20 13:38:10 +03:00

94 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Инструменты для музыки
## Что установлено
| Инструмент | Зачем | Где |
|---|---|---|
| **beets 2.14.1** | теги, структура, метаданные из MusicBrainz | `/opt/music-tools/venv`, обёртка `/usr/local/bin/beet` |
| **yt-dlp** | загрузка аудио/видео (инструмент; права на контент — на пользователе) | `/usr/local/bin/yt-dlp` |
| **mutagen** | чтение и запись тегов | venv |
| **musicbrainzngs** | метаданные MusicBrainz | venv |
| **ffmpeg 7.1.5** | перекодирование, извлечение звука | системный |
| **fpcalc** (chromaprint) | отпечатки для поиска дублей | системный |
| **Navidrome** | сервер прослушивания | CT 125 |
| **Lidarr** | управление библиотекой и загрузками | CT 111 |
Пакеты ставились в venv, потому что системный pip упирается в
externally-managed: `pip install beets` падает на конфликте с пакетом
`requests` из Debian.
## Страница токена Яндекса
`/yandex.html` — получение токена без передачи пароля:
1. кнопка ведёт на `oauth.yandex.ru` с клиентом Яндекс Музыки;
2. после входа токен приходит в адресе (`#access_token=...`);
3. страница сама подставляет его в поле;
4. «Сохранить» → `POST /yandex/save` → файл `/root/.yandex-token` (600) →
сразу проверка через `/account/status`.
`GET /yandex/status` показывает: есть ли токен, чей аккаунт, есть ли Плюс.
Так я могу «запросить» токен сам — но последний шаг (вход в аккаунт)
делает владелец: пароль и второй фактор мне не нужны и не передаются.
## Чего не делаю
Скачивание защищённой музыки (ATL и т.п.) с торрентов и из сервисов в обход
подписки — нарушение авторских прав. Инструменты (Lidarr, yt-dlp, slskd)
нейтральны, но контент должен быть легальным: своя подписка, покупка,
свободная музыка.
---
## Lidarr
Поставлен в CT 111 (адрес **192.168.1.240**, порт 8686).
```
образ: ghcr.nju.edu.cn/linuxserver/lidarr (зеркало; lscr.io тянется слишком медленно)
тома: /music ← /mnt/media/music
/downloads ← /mnt/media/downloads
сеть: host (без bridge: с -p 8686:8686 порт не был виден с узла)
```
Настроено автоматически (`lidarr_setup.py`):
| Что | Значение |
|---|---|
| корневая папка | `/music` |
| клиент загрузки | qBittorrent `192.168.1.123:8085`, категория `lidarr` |
| синхронизация | Prowlarr → Lidarr (категории 3000–3040) |
Проверка: `GET /api/v1/system/status` → версия **3.1.0.4875**.
## Инструменты: `music_tools.py`
| Режим | Что делает |
|---|---|
| `--status` | библиотека, beets, Lidarr |
| `--import [путь]` | beets: теги и структура (`$albumartist/$album/$track $title`) |
| `--enrich` | обновление тегов из MusicBrainz |
| `--dupes` | поиск дублей по отпечаткам fpcalc |
```
=== БИБЛИОТЕКА ===
альбомов: 0, треков: 0
=== BEETS ===
beets version 2.14.1
=== LIDARR ===
Lidarr: версия 3.1.0.4875
артистов в Lidarr: 0
```
## Ловушки
* **Образы.** `lscr.io` и Docker Hub отдают слои крайне медленно; зеркало
`ghcr.nju.edu.cn` скачало образ за минуту.
* **Порт.** С `-p 8686:8686` контейнер слушал внутри CT, но с узла порт был
закрыт. Помогла host-сеть.
* **Адрес CT 111 — 192.168.1.240**, а не `.111`. Проверять `ip addr`, а не
угадывать.
* **f-string и шаблон beets.** `$album%aunique{}` внутри f-строки ломает
разбор (`{}` — выражение). Конфиг собирается обычной конкатенацией.