Skip to content
Aut0iqPublic

About

Music player for Navidrome and Subsonic servers — Android and Windows

Topics

Resources

Stars

43 stars

Watchers

2 watching

Forks

Latest commit

 

History

496 Commits

Folders and files

Repository files navigation

Vici

Latest release Build MIT Android, Windows and Linux Navidrome apps catalog Pairs with Coda

English · Русский

Library on desktop Player with visualizer
Library: sidebar, now playing cover, queue
Фонотека: боковое меню, обложка играющего трека, очередь
Full-screen player: cover on the left, visualizer on the right
Полноэкранный плеер: обложка слева, визуализатор справа
Home screen on a phone Player on a phone
Home: continue listening and library sections
Главная: продолжить слушать и разделы фонотеки
Player with the cover and a spinning vinyl
Плеер с обложкой и вращающейся пластинкой

English

Vici is a music player for your own Navidrome server and any other server with the Subsonic API. It runs on your phone and on your computer.

Vici is listed in the official Navidrome client apps catalog.

Pairs with Coda. Vici plays your Navidrome library; Coda is a separate app that sets up your own server to fill it. Connect them in Settings → Coda on Android, and search in Vici will also show songs and albums that are not on your server yet, so you can add them with a tap. Vici works on its own too: without Coda nothing changes.

Features

Look and feel

  • Cover-tinted background. The interface takes on the colors of the playing track and changes with it.
  • Blur instead of solid fills. The floating bottom bar, mini player and cards are translucent, with real blur and a light edge.
  • Full-screen player with the cover and a spinning vinyl. Swipe left or right on the cover to change tracks, up to open the lyrics, down to close the player.
  • Visualizer. Full-screen MilkDrop effects powered by butterchurn: 187 presets that react to the music.

Music

  • Lyrics with line-by-line highlighting, taken from your server or from LRCLIB. The track length is checked so the lyrics always match the song.
  • Last.fm scrobbling is sent straight from the device, nothing has to be set up on the server. It keeps an offline queue and counts sent scrobbles.
  • Endless random queue. The random button starts a mix from your whole library and keeps loading new tracks as you listen, without repeats.
  • Mixes. A separate tab for mood playlists whose names end with “mix”.
  • Continue listening. A card on the home screen with your last queue.
  • Caching of upcoming tracks for instant skipping and offline playback.
  • Radio stations, favorites, playlists, search, casting and everything else Castafiore can do.

Phone

  • Customizable bottom bar. Hide, restore or reorder any tab, and choose which tabs you can swipe between.
  • Swipe left and right to switch tabs.
  • Autoplay on headphones. Plug in your headset and the music keeps playing, even if the app was closed.
  • 5×1 home screen widget with the cover, title, controls and colors matched to the cover. Tap it to open the full-screen player.
  • Offline music. In Settings → Cache pick the albums to keep on the phone, or download the whole library. Cached music plays without a connection.
  • Save to the phone's Music folder. The three-dot menu of a track or an album downloads the original files to Music/Vici, where any other player can find them.

Terminal

  • vici-tui is a separate player for the Linux terminal, for servers and machines without a desktop.
  • Browse artists, albums and playlists, search, manage the queue, and play the endless random mix.
  • Everything is controlled from the keyboard; press ? for the list of keys.

Desktop

  • Sidebar with your playlists and a large cover of what is playing now.
  • Play queue in its own column on the right, so you can see what played and what comes next.
  • Full-screen mode with the cover on one half of the screen and the visualizer on the other; lyrics are shown over the visualizer.
  • Media keys on the keyboard and a track card in the system media controls.
  • Runs from the tray. Closing the window hides it, the music keeps playing.
  • Remembers the volume between launches.
  • Automatic updates. The app offers to install a new version by itself.

Installation

Android with Obtainium (automatic updates)

  1. Install Obtainium.
  2. Add App → paste https://github.com/Aut0iq/Vici → Add.
  3. Install Vici from the list. Obtainium will tell you about new versions.

Android manually

Download vici-*.apk from the latest release and open it on your phone.

Windows

Download Vici-Setup-*.exe from the latest release and run it. The installer does not need administrator rights and installs the app for the current user only. After that, Vici updates itself.

Linux

Download a package from the latest release:

  • Vici-*.AppImage runs on any distribution. Make it executable (chmod +x Vici-*.AppImage) and start it. It needs FUSE 2 (libfuse2), which most desktop distributions already have. The AppImage updates itself.
  • Vici-*.deb is for Debian, Ubuntu and their derivatives: sudo apt install ./Vici-*.deb.

Linux terminal

Download vici-tui_*_all.deb from the latest release and install it:

sudo apt install ./vici-tui_*_all.deb
vici-tui

The package pulls in Node.js and mpv, which plays the audio. On other distributions, install Node.js 18 or newer and mpv, unpack vici-tui-*.tar.gz and run node src/index.js.

On first launch, enter your server address (for example, https://music.example.com), username and password.

Building from source

You need Node.js 22, JDK 17 and the Android SDK.

npm ci

# Development build (installs next to the regular app and works with the dev server)
npx cross-env IS_DEV=true expo run:android

# Regular APK
npx expo prebuild --clean --platform android
cd android && ./gradlew assembleRelease -PreactNativeArchitectures=arm64-v8a

Desktop app

The desktop app is the Vici web build packaged with Electron. See desktop/README.md for details.

# Run in a window without building the installer
npm run desktop

# Build the installer into desktop/release
npm run export:desktop

Credits

License

Vici is released under the MIT license © 2026 Aut0iq.

You are free to use, modify and distribute the code, including in your own projects, as long as the copyright notice and the license text are kept.

Vici is based on Castafiore, whose source code is dedicated to the public domain (Unlicense).


Русский

Vici — музыкальный плеер для вашего собственного сервера Navidrome и любого другого с Subsonic API. Для телефона и для компьютера.

Vici есть в официальном каталоге клиентов Navidrome.

Работает в паре с Coda. Vici играет вашу фонотеку Navidrome, а Coda — отдельное приложение, которое разворачивает ваш собственный сервер для её пополнения. Подключите их в разделе Настройки → Coda на Android, и поиск в Vici будет показывать ещё и песни с альбомами, которых на сервере пока нет, — их можно добавить одним нажатием. Vici работает и сам по себе: без Coda ничего не меняется.

Возможности

Внешний вид

  • Фон из обложки. Интерфейс мягко окрашивается в цвета играющего трека и меняется вместе с ним.
  • Размытие вместо заливки. Парящее нижнее меню, мини-плеер и карточки сделаны полупрозрачными, с настоящим размытием и светлой кромкой.
  • Полноэкранный плеер с обложкой и вращающейся пластинкой. Свайп влево и вправо по обложке переключает трек, вверх открывает текст песни, вниз сворачивает плеер.
  • Визуализатор. Полноэкранные эффекты MilkDrop на движке butterchurn — 187 пресетов, реагирующих на звук.

Музыка

  • Тексты песен с построчной подсветкой: берутся с вашего сервера или из LRCLIB с проверкой длительности трека, чтобы текст не перепутался.
  • Скробблинг Last.fm отправляется прямо с устройства, серверу для этого ничего настраивать не нужно. Есть очередь для офлайна и счётчик отправленного.
  • Бесконечная случайная очередь. Кнопка случайного воспроизведения собирает микс из всей фонотеки и по ходу прослушивания догружает новые треки без повторов.
  • Миксы. Отдельная вкладка для плейлистов под настроение, чьё название заканчивается на «mix».
  • Продолжить слушать. Карточка на главной с последней очередью.
  • Кэширование соседних треков для мгновенного переключения и работы без сети.
  • Радиостанции, избранное, плейлисты, поиск, трансляция по сети и всё остальное, что умеет Castafiore.

Телефон

  • Настройка нижнего меню. Любую вкладку можно убрать из панели, вернуть обратно или переставить. Отдельно выбирается, участвует ли вкладка в переключении свайпом.
  • Переключение свайпом влево и вправо между вкладками.
  • Автозапуск при подключении наушников. Подключили гарнитуру — музыка продолжает играть, даже если приложение было закрыто.
  • Виджет 5×1 для рабочего стола: обложка, название, управление, цвет под обложку. Нажатие открывает плеер на весь экран.
  • Музыка без сети. В разделе Настройки → Кэш можно выбрать альбомы, которые останутся на телефоне, или скачать всю фонотеку. Музыка из кэша играет без подключения.
  • Сохранение в «Музыку» телефона. Через меню «три точки» трек или альбом скачивается в оригинале в папку Music/Vici, где его увидит любой другой плеер.

Терминал

  • vici-tui — отдельный плеер для терминала Linux: для серверов и машин без графики.
  • Исполнители, альбомы, плейлисты, поиск, очередь и бесконечный случайный микс.
  • Управление целиком с клавиатуры; список клавиш открывается по ?.

Компьютер

  • Боковое меню с плейлистами и крупной обложкой того, что играет сейчас.
  • Очередь воспроизведения отдельной колонкой справа: видно, что было и что будет дальше.
  • Полноэкранный режим с обложкой на одной половине экрана и визуализатором на другой; текст песни ложится поверх визуализатора.
  • Медиа-клавиши на клавиатуре и карточка трека в системной панели управления звуком.
  • Работа из трея. Крестик прячет окно, музыка продолжает играть.
  • Запоминает громкость между запусками.
  • Автообновление — приложение само предложит установить новую версию.

Установка

Android через Obtainium (с автообновлениями)

  1. Установите Obtainium.
  2. Add App → вставьте https://github.com/Aut0iq/Vici → Add.
  3. Установите Vici из списка. О новых версиях Obtainium сообщит сам.

Android вручную

Скачайте vici-*.apk со страницы последнего релиза и откройте его на телефоне.

Windows

Скачайте Vici-Setup-*.exe со страницы последнего релиза и запустите. Установщик не требует прав администратора и ставит приложение только для текущего пользователя. Дальше Vici обновляется сам.

Linux

Скачайте пакет со страницы последнего релиза:

  • Vici-*.AppImage работает в любом дистрибутиве. Сделайте файл исполняемым (chmod +x Vici-*.AppImage) и запустите. Нужен FUSE 2 (libfuse2) — в большинстве настольных дистрибутивов он уже есть. AppImage обновляется сам.
  • Vici-*.deb — для Debian, Ubuntu и производных: sudo apt install ./Vici-*.deb.

Терминал Linux

Скачайте vici-tui_*_all.deb со страницы последнего релиза и установите:

sudo apt install ./vici-tui_*_all.deb
vici-tui

Пакет сам подтянет Node.js и mpv, через который идёт звук. В других дистрибутивах поставьте Node.js 18 или новее и mpv, распакуйте vici-tui-*.tar.gz и запустите node src/index.js.

При первом запуске укажите адрес своего сервера (например, https://music.example.com), логин и пароль.

Сборка из исходников

Нужны Node.js 22, JDK 17 и Android SDK.

npm ci

# Версия для разработки (ставится рядом с обычной, работает с сервером разработки)
npx cross-env IS_DEV=true expo run:android

# Обычная сборка APK
npx expo prebuild --clean --platform android
cd android && ./gradlew assembleRelease -PreactNativeArchitectures=arm64-v8a

Версия для компьютера

Настольное приложение — это веб-сборка Vici, упакованная в Electron. Подробности в desktop/README.md.

# Запустить в окне, без сборки установщика
npm run desktop

# Собрать установщик в desktop/release
npm run export:desktop

Благодарности

Лицензия

Vici распространяется под лицензией MIT © 2026 Aut0iq.

Код можно свободно использовать, изменять и распространять, в том числе в своих проектах, при условии сохранения уведомления об авторских правах и текста лицензии.

Vici основан на Castafiore, исходный код которого передан в общественное достояние (Unlicense).

About

Music player for Navidrome and Subsonic servers — Android and Windows

Topics

Resources

Stars

43 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages