Moonfin for webOS is an enhanced fork of the official Jellyfin webOS client, optimized for the viewing experience on LG Smart TVs running webOS.
Moonfin for webOS builds on the solid foundation of Jellyfin with targeted improvements for TV viewing:
- Unified Library Support - Seamless playback from multiple Jellyfin servers
- Seamless switching between servers for content playback
- Improved server selection logic
Moonfin is the first webOS client with native Jellyseerr support.
- Browse trending, popular, and recommended movies/shows and filter content by Series/Movie Genres, Studio, Network, and keywords
- Request content in HD or 4K directly from your LG TV
- NSFW Content Filtering (optional) using Jellyseerr/TMDB metadata
- Smart season selection when requesting TV shows
- View all your pending, approved, and available requests
- Authenticate using your Jellyfin login (permanent local API key saved)
- Global search includes Jellyseerr results
- Rich backdrop images for a more cinematic discovery experience
- Quick access home button and search functionality
- Shuffle button for instant random movie/TV show discovery
- Genres menu to browse all media by genre in one place
- Dynamic library buttons automatically populate based on your Jellyfin libraries
- One-click navigation to any library or collection directly from the navbar
- Cleaner icon-based design for frequently used actions
- Theme Music Playback - Background theme music support for TV shows and movies with volume control
- Pre-Playback Track Selection - Choose your preferred audio track and subtitle before playback starts (configurable in settings)
- Next Episode Countdown - Skip button shows countdown timer when next episode is available
- Metadata organized into clear sections: genres, directors, writers, studios, and runtime
- Taglines displayed above the description where available
- Cast photos appear as circles for a cleaner look
- Fits more useful information on screen without feeling cramped
- Accent Color Customization - Personalize the UI with your preferred accent color
- Item details show up right in the row, no need to open every title to see what it is
- Buttons look better when not focused (transparent instead of distracting)
- Better contrast makes text easier to read
- Transitions and animations feel responsive
- Consistent icons and visual elements throughout
Download the latest IPK from the Releases page.
Supported Devices:
- LG Smart TVs running webOS 3.0+
- LG webOS TVs (2016 and newer models)
To enable media discovery and requesting:
- Install and configure Jellyseerr on your network (jellyseerr.dev)
- In Moonfin, go to Settings → Jellyseerr
- Enter your Jellyseerr server URL (e.g.,
http://192.168.1.100:5055) - Click Connect with Jellyfin and enter your Jellyfin password
- Test the connection, then start discovering!
Your session is saved securely and will reconnect automatically.
- Enable Developer Mode on your LG TV
- Install the webOS Dev Mode app from the LG Content Store
- Use the ares-cli tools to install the IPK (see Building from Source section)
- Node.js and npm
- webOS SDK (ares-cli tools)
There are three ways to create the required build environment:
- Full webOS SDK Installation
- Docker
- NPM ares-cli
Install the webOS SDK from http://webostv.developer.lge.com/sdk/installation/
A prebuilt docker image is available that includes the build and deployment dependencies, see Docker Hub.
This requires npm, the Node.js package manager.
Execute the following to install the required webOS toolkit for building & deployment:
npm installNow you can package the app by running:
npm run packagedev.sh is a wrapper around the Docker commands. If you have installed the SDK directly, just omit that part.
# Build the package via Docker
./dev.sh ares-package --no-minify services frontend
# Build the package with natively installed webOS SDK
ares-package --no-minify services frontend- Uses npm for dependency management
- webOS SDK or Docker recommended for development
- Code style follows upstream Jellyfin conventions
- UI changes should be tested on actual LG TV devices when possible
Testing on a TV requires registering a LG developer account and setting up the devmode app.
Once you have installed the devmode app on your target TV and logged in with your LG developer account, you need to turn on the Dev Mode Status and Key Server.
Make sure to take a note of the passphrase.
# Add your TV. The defaults are fine, but I recommend naming it `tv`.
./dev.sh ares-setup-device --search
# This command sets up the SSH key for the device `tv` (Key Server must be running)
./dev.sh ares-novacom --device tv --getkey
# Run this command to verify that things are working.
./dev.sh ares-device-info -d tv
# This command installs the app. Remember to build it first.
./dev.sh ares-install -d tv org.moonfin.webos_*.ipk
# Launch the app and the web developer console.
./dev.sh ares-inspect -d tv org.moonfin.webos
# Or just launch the app.
./dev.sh ares-launch -d tv org.moonfin.webosWe welcome contributions to Moonfin for webOS!
- Check existing issues - See if your idea/bug is already reported
- Discuss major changes - Open an issue first for significant features
- Follow code style - Match the existing codebase conventions
- Test on TV devices - Verify changes work on actual LG TV hardware
- Consider upstream - Features that benefit all users should go to Jellyfin first!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes with clear commit messages
- Test thoroughly on LG TV devices
- Submit a pull request with a detailed description
- Issues - GitHub Issues for bugs and feature requests
- Discussions - GitHub Discussions for questions and ideas
- Upstream Jellyfin - jellyfin.org for server-related questions
Moonfin for webOS is built upon the excellent work of:
- Jellyfin Project - The foundation and upstream codebase
- Jellyfin webOS Contributors - All the developers who built the original client
- Moonfin Contributors - Everyone who has contributed to this fork
This project inherits the MPL 2.0 license from the upstream Jellyfin webOS project. Some parts incorporate content licensed under the Apache 2.0 license. All images are taken from and licensed under the same license as https://github.com/jellyfin/jellyfin-ux. See the LICENSE file for details.
Moonfin for webOS is an independent fork and is not affiliated with the Jellyfin project.
← Back to main Moonfin project