Litefin

A High-Performance, Native Jellyfin Client for Samsung Tizen and LG web-OS TVs

Litefin is designed to provide a premium media browsing and playback experience, even on legacy hardware. It features a robust dual-backend player, advanced subtitle support, and a highly optimized UI engine.

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 the project
npm run build

# For Tizen Only: Add your Tizen certificates to a .sign folder or just use Apps2Samsung

# Build all packages
npm run package

Quick Installation

Samsung Tizen TVs

The easiest way to install on a Samsung TV is with the Apps2Samsung installer:

1. Download the latest .wgt from the Releases page.
2. Use Apps2Samsung to sideload the .wgt to your TV.

LG web-OS TVs

Litefin can be installed on LG TVs using the Homebrew Channel:

1. Install the Homebrew Channel on your LG TV by following the instructions in its repository.
2. Either install through the Homebrew Channel UI or Download the latest .ipk for your hardware from the Releases page.
3. Open the Homebrew Channel on your TV and use the Package Manager to sideload the .ipk file.

Support

If Litefin is useful to you, please consider supporting the development:

• Sponsor this project on GitHub

A massive thank you to the individuals supporting the development of LiteFin!

License

Litefin is subject to the terms of the Mozilla Public License, v. 2.0. See the LICENSE file for more details.