$ show MoazSalem/litefin
Litefin is a high-performance, native Jellyfin media client designed specifically for Samsung Tizen and LG webOS smart TVs. It is built as a single-page web application using vanilla JavaScript with a custom component framework, no external UI libraries. The architecture is event-driven, centered around a global EventBus, StateManager, and Router. The application provides full media browsing, playback with advanced subtitle rendering (ASS/SSA via libass-wasm), live TV with EPG, SyncPlay group synchronization, a plugin system, and integration with Jellyseerr for media requests. It is optimized for TV remote control navigation with a sophisticated FocusManager and spatial navigation engine. The system communicates with a Jellyfin server via REST API and WebSocket for real-time events. It also integrates with TMDB (via Jellyseerr) for metadata and trailers, and uses a background service (Luna on WebOS, HTTP proxy on Tizen) for device discovery, Wake-on-LAN, and Smart Hub preview. The codebase is organized into core modules (App, Router, EventBus, StateManager), UI components (pages, modals, grids), a player subsystem with OSD menus, and platform adapters for Tizen and WebOS. It supports multiple build variants (Modern, Normal, Legacy, Ultra-Legacy) to accommodate different Chromium versions on TV firmware. Key entry points include src/index.js (bootstrap), src/core/App.js (orchestration), and src/core/Router.js (navigation). Data flows primarily through the ApiClient for Jellyfin endpoints and the WebSocketHandler for server push events. The plugin system allows third-party extensions like skip-intro and mdblist-ratings. The application is heavily optimized for TV hardware, using GPU-accelerated CSS transforms, lazy loading, and memory-efficient virtual scrolling.
The LLM identified 5 files worth highlighting for reuse:
A lightweight, decoupled publish-subscribe event system used throughout the application. It provides on/off/emit methods with support for wildcard events and once listeners. The implementation is clean, has no internal dependencies, and can be extracted into any JavaScript project for decoupled communication.
An observable state container that allows modules to subscribe to specific state changes. It supports nested state updates, batch notifications, and computed values. The pattern is self-contained and reusable for any application needing reactive state without a framework.
A sophisticated focus management system for TV remote control navigation. It supports section registration, focus traps, spatial navigation with direction scoring, focus memory, and self-healing for lost focus. Despite its complexity, it is isolated from the rest of the UI and can be reused in any 10-foot UI project.
A sandboxed API for third-party plugins that exposes controlled access to player, OSD, focus, storage, and event bus functionality. It enforces lifecycle management (init, destroy) and prevents plugins from directly accessing internal modules. The pattern is a clean example of a plugin architecture that can be adapted for other extensible applications.
A GPU-accelerated scroll animation engine that uses requestAnimationFrame with easeOutQuad easing, native smooth-scroll fallback, and offset caching. It supports both vertical and horizontal scrolling with configurable thresholds and skip options. The implementation is self-contained and can be extracted for any project needing smooth programmatic scrolling.