Skip to content

Configuration

Jump to bottom
blarns edited this page Jun 3, 2026 · 1 revision

Configuration

Required: Supabase keys

NuvioForLinux uses Supabase for authentication and cloud sync. You must provide your own Supabase project keys before the app will work.

Getting the keys

  1. Create a free project at supabase.com
  2. Go to Project Settings → API
  3. Copy the Project URL and anon/public key

Setting the keys

Create a file named local.properties in the root of the cloned repository:

SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_ANON_KEY=your-anon-public-key

This file is git-ignored and will not be committed.

Without these keys, authentication will fail at runtime and you will not be able to log in or sync watch history.

Optional: Trakt integration

Trakt scrobbling is configured inside the app under Settings → Trakt. No extra configuration file is needed — OAuth is handled via a localhost redirect.

Settings stored by the app

All settings are persisted automatically. Desktop-specific settings are stored in two places:

What Where
Player settings (VA-API, audio output, etc.) ~/.java/.userPrefs/nuvio/player/
Watch progress, collections, preferences ~/.local/share/nuvio/prefs/
Window size ~/.java/.userPrefs/com/nuvio/app/

To reset all settings, delete both directories.

Gradle properties

For machines with limited RAM, you can cap Gradle's heap in gradle.properties:

org.gradle.jvmargs=-Xmx2g

The default is usually sufficient on machines with 8 GB or more.

Clone this wiki locally