Руководства

Решение проблем

Что делать при заблокированной медиатеке, остановленной службе, ошибках воспроизведения и нехватке инструментов.

Медиатека заблокирована

Демон нашёл library.db, но не нашёл ключ, который её открывает. Введите 24 слова фразы восстановления на экране блокировки («Откройте медиатеку»). Nuvo никогда не заменяет существующую базу данных, поэтому ваши данные в безопасности, пока вы не разблокируете их.

Причины: хранилище ключей сбросили, вы перешли на другую учётную запись или хранилище ключей не запущено.

Если вы потеряли фразу и ключа больше нет, медиатеку открыть нельзя. Восстановите копию, для которой у вас сохранилась фраза. См. резервные копии.

Ожидание при запуске

При старте Nuvo ждёт хранилище ключей. Окно с просьбой разблокировать хранилище может появиться за окном Nuvo. Nuvo ждёт его до двух минут.

«Медиатека остановилась»

Демон упал четыре раза за минуту, и Nuvo сдался. Перезапустите Nuvo. Если повторяется, посмотрите лог в ~/.local/state/nuvo/core.log и откройте issue, приложив отчёт из «Настройки», «Сеть».

Одиночный сбой Nuvo обработает сам: службу он перезапустит за несколько секунд, а воспроизведение продолжится.

Уже запущен другой демон

Сообщение «another nuvo-core is already running» значит, что на сокете уже отвечает демон. Закройте другой экземпляр Nuvo. Устаревший файл сокета после сбоя заменяется автоматически.

Трек не играет

  1. Запустите проверку сети («Настройки», «Сеть»). См. сеть и прокси.
  2. Войдите в YouTube в «Настройки», «YouTube». Вход помогает избежать блокировки потоков.
  3. Проверьте зависимости: проверка отмечает yt-dlp как устаревший через 90 дней и сообщает, если он отсутствует.
  4. Попробуйте ещё раз. Если один источник не сработал, Nuvo переходит к другому источнику той же песни.

Треки SoundCloud могут не играть по причинам, которые показывает плеер, например из-за региональной блокировки.

Локальный файл не играет

Файлы в кодеке, который плеер не умеет декодировать, например ALAC, показываются в списке с причиной. Любимый трек в этом случае играет своим стриминговым совпадением.

Вставленная ссылка ничего не делает

  • Ссылки Spotify не читаются. Импортируйте CSV.
  • Для TikTok и распознавания нужны yt-dlp и ffmpeg. Чего не хватает, показано в настройках. Установите их и нажмите проверку ещё раз.
  • Распознавание по системному звуку требует ffmpeg с входом PulseAudio.
  • Чтобы справиться с проверками YouTube, yt-dlp нужна среда выполнения JavaScript (deno, node или bun).

Нет Notch

GNOME на Wayland не может закрепить окно. Используйте системный виджет медиа. См. трей и Notch.

Нет значка в трее

Трею нужен наблюдатель StatusNotifier. В GNOME установите расширение AppIndicator.

Сломан внешний вид

Удерживайте Shift при запуске Nuvo или используйте --safe-appearance. См. темы и свой CSS.

Медленный или слишком большой кэш

В «Настройки», «Хранилище» видно, сколько занято, и можно задать лимит («Лимит кэша») или очистить кэш. См. кэш аудио.

Где лог

~/.local/state/nuvo/core.log. В нём записаны маршруты и время, а идентификаторов треков нет.