Moonfin

---

← Back to main Moonfin project

Moonfin is a media client for Jellyfin, Emby, Plex and Silo servers, built with Flutter. One shared codebase powers phones and tablets, Windows, macOS, and Linux, Android TV, Fire TV, and Apple TV, and the browser. It's made for people who want a modern, customizable experience on every screen they own.

Where to get it

Platform	Download
Android Mobile / TV
Fire TV
iOS
Linux
macOS
tvOS
Windows	or winget install Moonfin.Moonfin

Supported Servers

Server	Minimum Version	Status
Jellyfin	10.8.0+	Full support
Emby	4.8.0.0+	Full support (the admin panel needs 4.9+)
Plex	Plex Media Server 1.43+	Supported, without the features that need the Moonbase plugin
Silo	API v2 (api_major 2)	Supported through Silo's native API, see below

Silo

Moonfin talks to Silo through its native API (/api/v2), not its Jellyfin-compatible service. Add the server by its native address, which is usually port 8090 with Silo's Docker setup. If you enter the Jellyfin-compatible address on port 8096, Moonfin offers to switch to the native one. Silo servers on your local network also show up under Discovered Servers.

Sign-in with a password or a code, Home, libraries, search, favorites, watched state, ratings, collections, playback, skip intro and credits, trickplay, household profiles with their PINs, and downloads with offline progress sync all work.

Requests use Silo's own requests feature in place of Seerr, and Watch Together uses Silo's Watch Party in place of SyncPlay. Settings sync, admin defaults, server messages, custom themes and MDBList and TMDB ratings need the Moonbase plugin installed in Silo.

Live TV and DVR, music, playlists, remote control of other devices, the server admin panel (Silo's is in its web app) and retro games aren't available on Silo, so Moonfin hides them while a Silo server is active. Books, audiobooks, 4K requests and Silo's server-side download subscriptions aren't supported yet.

If a Silo server has a newer API than your version of Moonfin, Moonfin won't connect to it and asks you to update Moonfin.

Platform Support

Platform	Minimum Version	Status
Android	7.0 (API 24)	Full support
Android TV / Google TV	Android 7.0 (API 24)	Full support
Fire TV	Fire OS 6	Full support
iOS	18.0	Full support
Apple TV (tvOS)	18.0	Full support
macOS	15.0 (Sequoia)	Full support
Windows	10 (x64 and ARM64)	Full support
Linux	GTK 3+, CMake 3.13+	Full support (Wayland and X11)
Web	Modern browsers (installable PWA)	Full support

Android TV, Fire TV, and Apple TV ship from this same codebase with a TV-tuned interface and D-pad navigation. Fire TV runs the same native backend as Android TV. Web runs as an installable PWA through the Moonbase server plugin.

Features

• One codebase, every screen. Phones, tablets, desktop, Android TV, Apple TV, and web, with navigation tuned for touch, pointer, and remote.
• Playback that just works. Wide codec support including AV1, HEVC, Dolby Vision, Dolby Atmos, HDR10+, and audio passthrough. Dolby Vision Profile 7 direct plays on Apple and Android TV, converted in real time instead of transcoded, with both layers of FEL files on Apple devices, and Windows can send HDR to the display untouched. Two subtitle tracks can show at once on every player. See Playback and Codecs.
• A mini player on desktop that keeps the video playing in a bar along the bottom while you browse.
• Offline downloads in original or smaller server-transcoded quality, with automatic folder organization, offline subtitles, automatic downloads of new episodes for the series you follow, and Smart downloads on phones and tablets that keep the next episodes of a show downloaded and clear them once watched. See Downloads.
• Ebooks and audiobooks. Read EPUB, MOBI, AZW/AZW3, PDF, and comic archives, with your reading progress synced to the server. Play M4B audiobooks with chapter navigation.
• Retro games browsed and played in-app from a server game library, with gamepad support, save states and battery saves that sync between devices, hardware rendering on Android, and RomM-backed libraries you browse with your own RomM account. See Retro Games.
• Multi-server unified library that merges several Jellyfin and Emby servers into one browsable, searchable UI.
• Library styles for video, music, and book libraries, from the classic grid to a docked side panel, an immersive music hero, or a bookstore shelf.
• A setup wizard on first run that asks how you want the app to look, with live previews built from your own artwork.
• Five detail screen styles to pick from: Classic, Modern, Spotlight, Nouveau, and Minimalist.
• Featured media bar with six layouts, plus optional in-bar trailer previews.
• Themes and a Theme Store with a built-in editor, server-side sync, and an OLED mode for true blacks, plus custom loading animations and a screensaver on TV.

The full list is on the Features wiki page.

Screenshots

TV and desktop

Mobile

Installation

The store links above are the easy route. To install a file yourself, download it from the Releases page and pick the one for your device:

Platform	File
Android (phones and tablets)	Moonfin_Android_v<version>.apk
Android TV / Google TV / Fire TV	Moonfin_AndroidTV_v<version>.apk
iOS	Moonfin_iOS_v<version>_unsigned.ipa (for self-signing)
Apple TV	Moonfin_tvOS_v<version>_unsigned.ipa (for self-signing)
Windows x64	Moonfin_Windows_v<version>.exe
Windows ARM64	Moonfin_WindowsARM64_v<version>.exe
macOS	Moonfin_macOS_v<version>.dmg
Linux x64	Moonfin_Linux_v<version>.<ext> (AppImage, deb, rpm, snap, flatpak, tarball)
Linux ARM64	Moonfin_LinuxARM64_v<version>.<ext> (same formats)
Web	Served as a PWA by the Moonbase server plugin, no download needed

On Arch Linux, install from the AUR with yay -S moonfin-bin (or paru -S moonfin-bin, pamac build moonfin-bin).

Click-by-click steps for every platform are on Installation, and Getting Started covers connecting to your server for the first time.

Building

Flutter stable 3.47 or newer is the one thing every platform needs (Dart 3.13 comes with it). Each target also needs its own toolchain: Android Studio with the SDK and NDK for Android, Xcode and CocoaPods for iOS and macOS, the flutter-tvos toolchain for Apple TV, Visual Studio and vcpkg for Windows, and a handful of development packages on Linux. Every Android command also takes a --flavor.

git clone https://github.com/Moonfin-Client/Moonfin-Core.git
cd Moonfin-Core
flutter pub get

The per-platform build commands are on Building from Source.

Documentation

The deeper reference material lives in the Wiki:

Page	What it covers
Features	The full feature list, section by section
Playback and Codecs	The backend per platform, the codec table, HDR, and audio passthrough
Downloads	Original and transcoded downloads, quality presets, and storage paths
Retro Games	Playing server game libraries in-app, cores, controllers, and save states
Installation	App store links first, then installing a release file by hand on every platform, and how updates work
Getting Started	Connecting to your server, Quick Connect, the setup wizard, and the settings worth a look on day one
User Guide	The player on touch, remote and keyboard, Live TV, casting and remote control, Seerr requests, downloads, subtitle downloads, themes, parental controls, and Kids Mode
Common Problems	Plain fixes for connection, login, playback, sound, subtitle, download and casting trouble
Collecting Logs	Capturing a diagnostic report for a bug report
Custom mpv Configuration

Contributing

Contributions are welcome. Check the existing issues first, discuss major feature changes before implementing them, match the existing code style, run flutter analyze, and test on at least one target platform. Keep pull requests focused and include context, screenshots or logs where useful.

See CONTRIBUTING.md for the full guidelines and the pull request process.

Help translate Moonfin here

Support and Community

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Discord: Discord
• Upstream Jellyfin: jellyfin.org

Credits

Moonfin is built on the work of:

• Jellyfin Project
• Jellyfin client contributors
• Moonfin contributors
• MakD - Original Jellyfin-Media-Bar concept that inspired our featured media bar
• MediaLyze The Admin analytics UI was inspired by this open-source project

License

Moonfin is free software. You can redistribute it and modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or, at your option, any later version. See LICENSE for the version 2 text.

---