Profiles and Sharing
OmniLux supports both local server users and account-linked household access. The exact flow depends on whether the server is running standalone or has been claimed to an OmniLux cloud account.
Two sharing models
Local-only server users
Use this when the server is operating entirely on your own network and you are managing access inside the server itself.
Cloud-linked household access
Use this when the server has been claimed to an OmniLux account and you want invites, account-based access, and shared device flows managed from the cloud dashboard.
Creating local server users
- Go to Settings > Users
- Click Create User
- Enter username, password, and role
- The user can sign in directly against the server
Roles
| Role | Capabilities |
|---|---|
| Admin | Full access: settings, user management, library management, requests, downloads, all media |
| User | Browse library, stream media, make requests, manage own profile and preferences |
| Guest | Browse and stream only. No requests, no profile settings |
Permission flags
Beyond roles, individual permission flags provide granular control:
- REQUEST — can submit content requests
- VIEW_ISSUES — can view and report issues with media
Admins can toggle these per user.
Inviting people through the cloud account
When a server is claimed, you can invite people from the OmniLux dashboard instead of handing out local credentials.
This is the preferred model for:
- Family or household access
- Shared mobile and TV app usage
- Account-linked device sign-in
- Plans that depend on cloud-connected features
User preferences
Each user has their own preferences:
- Default quality — preferred streaming quality (original, 1080p, 720p, etc.)
- Default subtitle language — auto-select subtitles in this language
- Default audio language — prefer this audio track when available
- Theme — light or dark mode preference
Set preferences at Profile > Preferences or via the API.
PIN-based device pairing
TV and other big-screen devices use PIN pairing instead of username/password:
- Open OmniLux on your TV device
- The TV displays a 4-digit PIN
- On your phone or computer, complete the pairing flow tied to your server or account
- Enter the PIN
- The TV is now linked to your account
This avoids typing passwords on TV remotes. The pairing persists until you explicitly unpair the device.
Profile selection
When multiple users share a device, OmniLux shows a "Who's watching?" screen on launch (like Netflix). Each user selects their profile to get personalized recommendations, continue watching, and preferences.
Activity and playback history
Each user has their own:
- Watch history — what they've watched and when
- Continue watching — resume points for in-progress media
- Playback statistics — hours watched, most-watched genres, etc.
Admins can view aggregate activity for all users on the Activity page.
Recommended model
- Use local users if your server stays fully local and browser-based
- Use cloud-linked invites if you want native apps, shared household access, or a cleaner multi-device sign-in flow