Configuration

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.