LumaFin
LumaFin

A better-looking Jellyfin client for your TV.

Landscape artwork, rating badges and a home screen you can arrange exactly how you like. Free and open source, for Android TV, Fire TV, Nvidia Shield and Samsung Tizen TVs.

Download See what's different
LumaFin home screen with Continue Watching and Next Up rows of landscape artwork and rating badges

Download

Pick your TV. Both apps install alongside the official Jellyfin app and work with any Jellyfin server.

What's different

LumaFin follows the official Jellyfin clients for fixes and new features, and adds a look inspired by popular Jellyfin web themes.

  • Landscape, thumbnail-first artwork

    Every card is a uniform 16:9 tile that prefers Thumb, then Backdrop, then Primary artwork. Continue Watching shows proper series art for episodes.

  • Rating badges

    Critic and community ratings appear right on movie and series cards, so you can pick something to watch at a glance.

  • More home sections

    Add Latest Movies and Shows, Because You Watched, Collections, Watch Again, Genres, Favorites, a combined Continue Watching / Next Up row and more.

  • A home screen that stays yours

    Reorder and hide sections with the remote. The layout is saved on the TV, so a session refresh or another Jellyfin client can't undo it.

  • Web-style playback controls

    Android TV gets a seek bar with elapsed and remaining time, chapter marks, and subtitles, audio, speed and quality one press away.

  • Installs alongside Jellyfin

    LumaFin has its own app ID, so you can keep the official Jellyfin app installed and switch between them any time.

Details screens

Movie details screen with artwork on the left and runtime, genres and ratings in the header
Movie details
Episode details screen showing the series name above the episode title
Episode details

How to install

LumaFin isn't in the Google Play or Samsung app stores yet, so it's installed by sideloading.

Android TV, Google TV, Shield and Fire TV

Easiest: the free Downloader app, no computer needed

  1. Install Downloader by AFTVnews from the Google Play Store or Amazon Appstore on your TV.
  2. Allow it to install apps. On Fire TV: Settings → My Fire TV → Developer options → Install unknown apps (if Developer options is hidden, open About and press your device name 7 times). On Google TV and Android TV: Settings → Apps → Security & restrictions → Unknown sources, then turn on Downloader.
  3. Open Downloader and enter getlumafin.com/android. It downloads the latest APK.
  4. Choose Install, then open LumaFin and sign in to your Jellyfin server.
Prefer a computer? Install with ADB
  1. Turn on Developer options → USB / network debugging on the TV.
  2. Download the APK above, then run:
adb connect <TV_IP>
adb install -r LumaFin.apk

To update, install the new version over the old one. Your sign-in and settings are kept.

Samsung Tizen TVs

Needs a computer with Tizen Studio (free from Samsung)

  1. On the TV, open Apps, press 1 2 3 4 5 on the remote, turn Developer mode on and enter your computer's IP address. Restart the TV.
  2. Install Tizen Studio with the TV extension, and create a certificate profile in Certificate Manager.
  3. Download the WGT above, then connect and install:
sdb connect <TV_IP>
tizen install -n LumaFin.wgt -t <TV_NAME>

Reinstalling over an existing copy keeps your sign-in. Uninstalling first clears it.

FAQ

Is LumaFin an official Jellyfin app?

No. LumaFin is an independent, community fork of the official Jellyfin TV clients. It isn't affiliated with or endorsed by the Jellyfin project. For the official apps, visit jellyfin.org.

Do I need my own Jellyfin server?

Yes. LumaFin is a client: it plays media from a Jellyfin server you run or have access to. It works with any Jellyfin server.

Can I keep the official Jellyfin app installed?

Yes. LumaFin uses its own app ID, so both apps install side by side.

Is it free?

Yes, and it always will be. LumaFin is open source, and the code for both apps is on GitHub. If you'd like to support development, you can sponsor it on GitHub.

How do I update?

Download the latest release and install it over your current version. On Android TV, entering getlumafin.com/android in Downloader always fetches the newest APK.

Where do I report a bug or ask for help?

Open an issue on GitHub for Android TV or Tizen, or email support@getlumafin.com.

Enjoying LumaFin?

LumaFin is built in spare time. Sponsorship is entirely optional, and LumaFin will stay free and open source.

Sponsor on GitHub