Lumière icon Lumière / You at home

Lumière support

Support and Help

Answers about server setup, Lumière Server, playback, audio, subscriptions, and your data.

Frequently asked questions

How do I connect my media server or network folder?

Open Settings in Lumière, navigate to Servers, and tap Add Server. Choose your server platform: Lumière Server, Plex, Jellyfin, Emby, Kodi, or Network Folder (SMB, NFS, FTP, or WebDAV).

Enter your server's local IP address or domain name and sign in with your credentials. When prompted by iOS, iPadOS, macOS, or tvOS, allow Lumière access to your Local Network.

What is the Lumière Playback Engine?

The Lumière Playback Engine remuxes video files on-device into a local HLS stream using your Apple device's native hardware. Your NAS or home server does not need to transcode these files.

On compatible devices it supports hardware-accelerated 4K, HDR10, Dolby Vision (Profile 5 and 8.1), and Dolby Atmos from compatible Dolby Digital Plus tracks. It decodes Dolby TrueHD and DTS-HD Master Audio to multichannel audio. Results depend on your device, audio system, and files. For other formats, playback automatically switches to the built-in VLC player. The engine requires Lumière Plus.

Does Lumière include movies, TV shows, or music?

No. Lumière is strictly a media player application for your own content. It does not provide, host, or license movies, television series, music, or streaming channels.

You must connect your own personal media server or shared network folder with content you have the right to access.

What are the restrictions of the Free tier?

Lumière Free gives you one usable saved server, 20 library titles on that server, the standard player, the manual Skip Intro button, and two active devices per iCloud account. The standard player plays your files in standard quality: at most 1080p, in standard colors (SDR), with stereo sound.

Limits lock access but do not delete your saved servers or favorites. Lumière Plus unlocks your whole library, all saved servers, all devices, the Lumière player, automatic intro skipping, Picture in Picture, and Audio Presets.

How does the two-device limit work on the Free plan?

Active devices are tracked automatically through your Apple iCloud account. If you open Lumière on a third device, you will see options to Use it here instead (which moves your active slot, and is available once every 24 hours) or upgrade to Lumière Plus for unlimited devices.

What do Audio Presets do?

Audio Presets tune the sound on your device: Cinema adds bass and detail, Clear Voice makes dialogue easier to follow, Theater widens the sound, and Night Mode brings loud scenes and quiet speech closer together. Default plays the original sound.

Choose a preset with the speaker button during playback, or in Settings. You can change it while you watch, in both the Lumière player and VLC. With a preset other than Default, Dolby audio plays as multichannel sound without Dolby Atmos. Audio Presets require Lumière Plus.

How do subtitles and audio tracks work?

During playback, bring up the playback HUD or audio/subtitle menu to select from available audio tracks and subtitle streams. Lumière can show Blu-ray PGS picture subtitles without server transcoding, along with common text subtitles such as SRT and WebVTT. Available options depend on your file and server.

How do I delete my data or get a refund?

Remove a server or clear your viewing history in Settings, or delete the app. Lumière has no account to close. Data on a media server is managed on that server.

Apple handles refunds. Request one at reportaproblem.apple.com ↗.

Why can’t Lumière find my server on the local network?

Check the following common network issues:

  • Ensure your Apple device and media server are connected to the same Wi-Fi or LAN subnet.
  • Verify that Local Network access is enabled in Apple device Settings → Lumière.
  • Check that server ports are not blocked by a firewall (e.g., port 5059 for Lumière Server, 32400 for Plex, 8096 for Jellyfin/Emby).
  • If using Kodi, ensure that Allow remote control via HTTP is enabled in Kodi's service settings.
What is Lumière Server, and is it free?

Lumière Server is an optional media server for the movies, shows, and music you already have. It runs as a native desktop app on Mac, Windows, and Linux, or on a NAS with Docker. It is free, has no account, and has no limits. You do not need it if you use Plex, Jellyfin, Emby, Kodi, or a network folder.

Install Lumière Server ↗

Lumière Server shows no posters. What do I do?

Without a key, the server uses free open sources: Wikidata, Wikipedia, and TVmaze. Many films have no poster there, so they show a frame from the video. For posters and full details, add your own free TMDB API key. Open the server page in a browser, select Settings, then Metadata, and paste the key. The server then updates every title by itself. Name each file by title and year, for example Heat (1995).mkv. If a title has the wrong match, open it and select Fix match.

If the key is set and no title has a poster, the container cannot reach the internet. This occurs on some NAS systems. Update to Lumière Server 1.0.6 or later and start the container again. If the problem stays, add --dns 1.1.1.1 --dns 8.8.8.8 to the docker run command.

Is Lumière Server safe to open to the internet?

No. Lumière Server has no password of its own. Anyone who can reach it can see the library and change its settings. Use it on your home network, or reach it from outside through a VPN that you control.

The server sends nothing to us. The Privacy Policy lists what it stores and which services it contacts.

How do I restore purchases or manage my Lumière Plus subscription?

Open the Lumière Plus screen in the app and choose Restore Purchases. Apple checks your purchases against your Apple Account.

Subscriptions can be modified or cancelled at any time in your Apple Account settings under Subscriptions.

Manage Apple subscriptions ↗