Litefin
Jellyfin & Emby Client for Smart TVs (Tizen, webOS, Android TV, Fire TV), Desktop (Windows, Linux, macOS) and Web
Litefin is a high-performance, open-source Jellyfin (and Emby) client engineered from scratch for Smart TVs and Desktop. Whether you're running it on Samsung Tizen, LG webOS, Android TV, Amazon Fire TV, or native Desktop (Windows, Linux, macOS), Litefin delivers a unified, zero-bloat experience with hardware-optimized playback backends, pixel-perfect subtitle rendering, and a butter-smooth interface even on legacy hardware.
Extend Litefin features by installing the Litefin Plugin on your Jellyfin or Emby servers.
Features
- Fast Native Performance: Built in pure vanilla JavaScript with zero heavy framework overhead, custom virtualized scrolling (
VirtualCardRow,VirtualGrid), and aggressive DOM recycling tailored for low-RAM TV hardware and desktop environments. - Hardware-Accelerated Multi-Engine Playback:
MediaCodecList), multichannel audio passthrough (TrueHD, DTS-HD MA, Atmos), and smart fallback for chipsets lacking AV1 hardware decoders (e.g., Amlogic S905X).
- Desktop (Movi & HTML5): High-performance WASM & WebCodecs engine (movi-player) alongside an optimized HTML5 video player backend with auto-failover.
- Subtitle Engine:
@jellyfin/libass-wasm (compiled to WebAssembly) with custom font support and low-VRAM modes.
- Native PGS image-based subtitle decoding via libpgs.
- Pure JavaScript text-based subtitle parser with granular styling overrides (color, font, size, shadows, vertical positioning, offset tuning).
- In-player subtitle search and download directly from OpenSubtitles/Jellyfin.
- Player Controls (OSD):
- Unified Remote & Input Navigation:
- Integrations & Plugins:
- TV & Desktop Interface & Theming:
- Comprehensive Media Support:
filters2, multi-source trickplay streams, and modern API headers.
- Admin Features: Edit item images, run metadata identification, and trigger library scans directly from the remote control.
- Multi-Tier Server Discovery: Instant connection via webOS Luna Service, Tizen HTTP service, local subnet scanning, Quick Connect QR code, and Wake-on-LAN (WoL) cold-boot support.
- Cross-Platform Build Pipeline & Packaging:
.exe, .msi), Linux (.deb, .AppImage, .rpm), and macOS (.dmg) built with Tauri v2.
Documentation
Comprehensive documentation is available in the documentations directory:
- Overview: Project introduction and the 8x build strategy.
- Architecture: Framework details (EventBus, FocusManager, Plugins).
- Plugins: How the plugin system works and how to create them.
- Playback: Tizen AVPlay, web-OS adapters, and Subtitle Manager.
- Features: Categorized list of all implemented functionality.
- UI & UX: Design system, components, and animation principles.
- Screenshots: Visual previews of the application.
- Development: Build pipeline, variants, and deployment guide.
- Localization: A doc for translation contributions.
Quick Start (Development)
# Install dependencies
npm install
Build Smart TV web bundles (Tizen / webOS)
npm run build
npm run package
Build and package for Desktop (Windows, Linux, macOS via Tauri)
npm run package:desktop
Or platform-specific:
npm run package:windows
npm run package:linux
npm run package:macos
Build and package for Android TV & Fire TV (.apk via Tauri)
npm run package:android-tvQuick Installation
Samsung Tizen TVs
The easiest way to install on a Samsung TV is with the Apps2Samsung installer:
- Download the latest
.wgtfrom the Releases page. - Use Apps2Samsung to sideload the
.wgtto your TV. - (Optional) Install and Configure Litefin Plugin on your Jellyfin server.
LG webOS TVs
Litefin can be installed on LG TVs using the Homebrew Channel:
- Install the Homebrew Channel on your LG TV by following the instructions in its repository.
- Either install through the Homebrew Channel UI or download the latest
.ipkfor your hardware from the Releases page. - Open the Homebrew Channel on your TV and use the Package Manager to sideload the
.ipkfile. - (Optional) Install and Configure Litefin Plugin on your Jellyfin server.
Android TV & Amazon Fire TV
- Download the latest
.apkfrom the Releases page. - Sideload the
.apkfile using adb (adb install litefin.apk), Send Files to TV (SFTV), Downloader, or your preferred file manager. - (Optional) Install and Configure Litefin Plugin on your Jellyfin server.
Desktop (Windows, Linux, macOS)
- Download the installer or package for your OS from the Releases page:
.msi or .exe installer.
- Linux: .deb, .rpm package, or standalone .AppImage.
- macOS: .dmg disk image.
- Install and launch Litefin on your machine.
Keyboard Controls (Desktop & Web)
| Key / Shortcut | Action |
| :------------- | :----- |
| Space / K | Play / Pause toggle |
| J / L | Seek backward / forward 10 seconds |
| ← / → | Navigate UI items or seek timeline during playback |
| ↑ / ↓ | Navigate UI items, menus, and OSD controls |
| Enter | Select / Activate focused item or reveal OSD |
| Esc / Backspace | Go back / Close modal / Exit player |
| F / F11 | Toggle Fullscreen |
| M | Mute / Unmute audio |
| Media Keys | Hardware Play, Pause, Next, Previous, Stop |
Support
If Litefin is useful to you, please consider supporting the development:
A massive thank you to the individuals supporting the development of LiteFin!
Paul Becker |
Clément Masson |
Anton Antonov |
Martin Ericson |
Paweł Zmarzły |
witek |
DatAres37 |
Dani Tesler |
h3xler |
domantas |
Colin P |
cozyportal |
License
Litefin is subject to the terms of the Mozilla Public License, v. 2.0. See the LICENSE file for more details.