Установка - Nuvo Документация

Nuvo рассчитан на Linux. Готовые сборки выпускаются в виде AppImage и .deb.

chmod +x Nuvo-*.AppImage
./Nuvo-*.AppImage

sudo apt install ./nuvo_*_amd64.deb

pnpm install
pnpm dev

Требования

Что нужно	Для чего
Хранилище ключей Secret Service (GNOME Keyring, KWallet или совместимое)	Хранит ключ медиатеки. Без него Nuvo держит ключ в закрытом файле, который можно защитить парольной фразой.
`yt-dlp` и среда выполнения JavaScript (`deno`, `node` или `bun`)	Необязательно. Вставленные ссылки на видео и распознавание песен.
`ffmpeg`	Необязательно. Сохранение в MP3 и распознавание песен.

Nuvo ищет yt-dlp и ffmpeg в PATH и в ~/.local/bin. Для воспроизведения они не нужны. В настройках есть проверка зависимостей: она покажет, чего не хватает.

Готовая сборка

Соберите AppImage и .deb:

pnpm install
pnpm electron:build:linux

Файлы появятся в release/:

Nuvo-<version>.AppImage
nuvo_<version>_<arch>.deb

Установите .deb через менеджер пакетов или сделайте AppImage исполняемым и запустите его.

Что нужно для сборки

Node 22 и pnpm
Стабильный набор инструментов Rust
SQLCipher

Запуск из исходников

pnpm install
pnpm dev

pnpm dev собирает демон в режиме отладки и запускает приложение. В сессии Wayland можно принудительно включить X11 командой pnpm dev:x11. Это удобно для проверки Notch.

Проверка сборки

pnpm check          # lint, format, build, dependency check, tests
pnpm core:test      # daemon tests and clippy

Windows и macOS

В конфигурации сборки есть цели для Windows (NSIS) и macOS (dmg, zip). Они не проверялись. Поддерживаемая платформа - Linux.

Сборки без подписи

Сборки Nuvo пока не подписаны. Сертификат для подписи кода под Windows и аккаунт разработчика Apple стоят денег каждый год, а Nuvo бесплатный, поэтому проект за них пока не платит. Система не может определить, кто сделал файл, и при первом запуске может предупредить вас. В предупреждении написано, что издатель неизвестен. Это не значит, что найден вирус.

Сначала проверьте файл. На страницах релизов указаны контрольные суммы SHA-256:

sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify <file> --repo Ziuziuk-Denys/nuvo

Windows. SmartScreen показывает «Windows защитила ваш компьютер» (Windows protected your PC). Нажмите Подробнее (More info), затем Выполнить в любом случае (Run anyway).

macOS. Первый запуск блокируется.

Перенесите Nuvo в папку «Программы» и откройте один раз. Закройте предупреждение.
Откройте Системные настройки (System Settings), затем Конфиденциальность и безопасность (Privacy & Security).
Прокрутите до раздела Безопасность (Security) и нажмите Всё равно открыть (Open Anyway) рядом с Nuvo. Подтвердите паролем.

Если macOS пишет, что приложение повреждено, уберите флаг загрузки в терминале и откройте приложение снова:

xattr -dr com.apple.quarantine /Applications/Nuvo.app

Linux. Пакеты ставятся без таких предупреждений. Сделайте AppImage исполняемым командой chmod +x. Менеджер пакетов может заметить, что файл .deb или .rpm не из репозитория.

Удаление

Удалите пакет или AppImage. Чтобы удалить и данные, сотрите пути из таблицы во введении и запись nuvo-core (элемент master-key) в хранилище ключей. Если удалить ключ, база данных станет нечитаемой.