Installation

Installation

Prerequisites

Java

Java 17 or newer is required.

# Ubuntu / Debian / Mint
sudo apt install openjdk-17-jdk

# Fedora / RHEL
sudo dnf install java-17-openjdk-devel

# Arch
sudo pacman -S jdk17-openjdk

Verify: java -version

VLC / libVLC

# Ubuntu / Debian / Mint
sudo apt install libvlc-dev vlc libavcodec-extra

# Fedora / RHEL
sudo dnf install vlc-devel

# Arch
sudo pacman -S vlc

Optional: VA-API drivers (hardware video acceleration)

GPU	Package (Ubuntu/Debian)
Intel (newer, Gen 8+)	sudo apt install intel-media-va-driver
Intel (older, up to Gen 9)	sudo apt install i965-va-driver
AMD	sudo apt install mesa-va-drivers
NVIDIA	sudo apt install nvidia-vaapi-driver

Verify VA-API is working: vainfo

Optional: Desktop notifications

sudo apt install libnotify-bin   # Ubuntu/Debian/Mint
sudo dnf install libnotify       # Fedora
sudo pacman -S libnotify         # Arch

---

Installing NuvioForLinux

1. Clone the repository

git clone https://github.com/blarns/NuvioForLinux.git
cd NuvioForLinux

2. Configure environment

See the Configuration page for Supabase key setup — this is required before the app will authenticate.

3. Build and run

./gradlew composeApp:run

The first build downloads dependencies and may take several minutes. Subsequent launches are fast.

---

App menu integration

To add Nuvio to your desktop application launcher:

bash scripts/install-desktop.sh

This copies nuvio.desktop to ~/.local/share/applications/ and updates the desktop database so the app appears in your launcher / application menu.

---

Distro notes

Ubuntu / Debian / Mint

Fully tested. Use the commands above verbatim.

Fedora / RHEL

Replace apt commands with dnf. VLC may require enabling the RPM Fusion repository:

sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
sudo dnf install vlc vlc-devel

Arch Linux

sudo pacman -S jdk17-openjdk vlc

NixOS

Not officially tested. Contributions welcome.

---

Uninstalling

Remove the cloned directory and optionally the app menu entry:

rm ~/.local/share/applications/nuvio.desktop
update-desktop-database ~/.local/share/applications/

Preferences and watch history are stored in ~/.local/share/nuvio/ and ~/.java/.userPrefs/com/nuvio/.