Apps and Sign-In

OmniLux supports two sign-in models:

• Directly against your self-hosted server in the browser
• Through your OmniLux cloud account on linked devices and native apps

If you are using paid cloud-connected features or native apps, claim your server to your account first.

Which surface should people use?

Surface	Best for	Sign-in model
Browser on the same network	Setup, administration, local playback	Direct to the server
Browser over Tailscale or your own domain	Power users and remote browser playback	Direct to the server
Native iOS, Android, Apple TV, Android TV apps	Polished everyday playback	OmniLux account plus claimed server
Shared TV devices	Household playback	Pairing or account-linked device flows

iOS (iPhone + iPad)

The universal iOS app adapts to both phone and tablet:

• iPhone: compact layout with bottom tab bar
• iPad: adaptive sidebar layout with split view

Features:

• Stream all media types (movies, TV, music, games)
• Offline downloads (coming soon)
• Virtual controller overlay for game streaming
• MFi controller support (PS5 DualSense, Xbox Wireless)
• Background audio for music playback
• Picture-in-Picture for video

Setup

1. Install from the App Store
2. Sign in with your OmniLux account
3. Choose the claimed server you want to use

If your server has not been claimed yet, finish Getting Started first.

tvOS (Apple TV)

Purpose-built for the Apple TV with focus-based navigation:

• Siri Remote: swipe to navigate, click to select, play/pause for playback
• Immersive hero banners on the home screen
• Full EPG guide with channel preview
• Game streaming with Siri Remote or MFi controller
• Profile selection ("Who's watching?")

Setup

1. Install from the tvOS App Store
2. Sign in with your OmniLux account or use the device pairing flow
3. Select the claimed server for playback

Android mobile

Material You design language, optimized for phones and tablets:

• Dynamic color theming based on your wallpaper
• Gesture navigation support
• Virtual controller overlay for game streaming
• Bluetooth gamepad support
• Picture-in-Picture for video
• Background audio for music playback

Setup

1. Install from the Play Store
2. Sign in with your OmniLux account
3. Choose your claimed server

Android TV / Google TV / Fire TV / NVIDIA Shield

Lean-back interface built with Compose for TV:

• D-pad navigation optimized for TV remotes
• Voice search integration
• Game streaming with connected controllers
• EPG guide with live preview
• Background audio channels

Fire TV

Same APK as Android TV. Sideload or install from the Amazon Appstore.

NVIDIA Shield

Full support including:

• NVIDIA GPU for local game rendering (when gaming agent runs on the Shield)
• AI upscaling via Shield's Tegra processor
• USB gamepad and controller support

Setup

1. Install from the Play Store (or sideload the APK)
2. Use your OmniLux account or the pairing flow shown on the device
3. Confirm the target server

Viewer web app

A lightweight web app at /viewer is available for people who only need playback:

• Browse and stream media
• No settings, no downloads, no admin features
• Works on any device with a modern browser
• Share the URL: http://your-server:4000/viewer

This is useful when you want simple browser access without the full cloud-linked app flow.

Pairing and household devices

Large-screen devices are designed to avoid password entry with remotes.

• TVs can use pairing codes
• Shared devices can offer a "Who's watching?" profile chooser
• Household access can be granted through server invites once the server is claimed

See Profiles and Sharing for household setup.

Platform support summary

Platform	App type	Primary auth path	Game streaming
iPhone/iPad	Native (SwiftUI)	OmniLux account	Yes
Apple TV	Native (SwiftUI)	OmniLux account or pairing	Yes
Android phone/tablet	Native (Compose)	OmniLux account	Yes
Android TV / Fire TV	Native (Compose for TV)	OmniLux account or pairing	Yes
NVIDIA Shield	Native (Compose for TV)	OmniLux account or pairing	Yes
Web browser	Web app	Direct server sign-in	Yes