Moonfin Moonfin

Use this command to install Moonfin:

winget install --id=Moonfin.Moonfin -e

A premium cross-platform Jellyfin client

Moonfin

Premium Jellyfin & Emby client for mobile, tablet, desktop, TV, and web

Moonfin is a cross-platform media client built with Flutter, designed for Jellyfin and Emby users who want a modern, customizable experience across mobile, tablet, desktop, TV, and web. A single shared codebase powers phones and tablets, Windows, macOS, and Linux, Android TV and Apple TV, the browser, and experimental Samsung TV (Tizen).

Supported Servers

Server	Minimum Version	Status
Jellyfin	10.8.0+	Full support
Emby	4.8.0.0+	Full support

Platform Support

Platform	Minimum Version	Status
Android	6.0 (API 23)	Full support
Android TV / Google TV	Android 6.0 (API 23)	Full support
iOS	16.0	Full support
Apple TV (tvOS)	17.0	Full support
macOS	14.0 (Sonoma)	Full support
Windows	10 (x64 and ARM64)	Full support
Linux	GTK 3+, CMake 3.13+	Full support (Wayland only)
Web	Modern browsers (installable PWA)	Full support
Tizen (Samsung TV)	Tizen 6.0+	Experimental

> Android TV and Apple TV ship from this same codebase with a TV-tuned interface and D-pad navigation, each on its own native backend. Web runs as an installable PWA through the Moonbase server plugin. Tizen is experimental and has real limitations, listed on the Installation page.

Features

One codebase, every screen spanning phones, tablets, desktop, Android TV, Apple TV, web, and Samsung TV, with navigation tuned for touch, pointer, and remote.
Broad playback support through AetherEngine on iOS, Apple TV, and macOS, native Media3 or libmpv on Android and Android TV, libmpv on Windows and Linux, and the browser's own player on web, covering AV1, HEVC, Dolby Vision, Dolby Atmos, HDR10+, and bitstream audio passthrough. See Playback and Codecs.
Offline downloads in original or server-transcoded quality, with automatic folder organization and offline subtitles. See Downloads.
Ebooks and audiobooks with EPUB, MOBI, AZW/AZW3, PDF, and comic archive reading, plus M4B audiobooks with chapter navigation.
Retro games browsed and played in-app from a server game library, with native libretro playback, gamepad support, and synced save states. See Retro Games.
Multi-server unified library that merges content from several Jellyfin and Emby servers into one browsable, searchable UI.
Featured media bar with Classic, Bookshelf, Gallery, and Banner layouts, and optional in-bar trailer previews.
Themes and Theme Store with a built-in editor and server-side sync.
Integrated admin panel for settings, users, libraries, logs, devices, and analytics without leaving the client.
Discovery with Seerr for trending, popular, and upcoming rows, with request status overlays.
Live TV and DVR with an EPG-style guide and recording management.
Cinema Mode and segment skipping for pre-rolls, intros, credits, and SponsorBlock.
Casting and remote control over Google Cast, DLNA, and AirPlay, plus control of other Jellyfin devices on your network.
SyncPlay for synchronized group watching.
Ratings from MDBList and TMDB, home row customization, parental controls with PIN, and in-app update checks.

The full list is on the Features wiki page.

Screenshots

Installation

Download platform artifacts from the Releases page.

Platform	File
Android / Android TV	`Moonfin_Android_v.apk`
iOS	`Moonfin_iOS_v.ipa`
Windows (x64 and ARM64)	`Moonfin_Windows_v.exe`
macOS	`Moonfin_macOS_v.dmg`
Linux	`Moonfin_Linux_v.` (AppImage, deb, rpm, snap, flatpak, tarball)
Web	Served as a PWA by the Moonbase server plugin

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

Per-platform notes and the Tizen toolchain setup are on Installation.

Building

Flutter stable 3.41+ and Dart 3.11+ are the only prerequisites.

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	Which release file to pick, the AUR package, and the Tizen toolchain
User Guide	Keyboard shortcuts, subtitle downloads, and remote device control
Custom mpv Configuration	Tuning playback with your own `mpv.conf`, allowed options, and SVP on Windows
Building from Source	Toolchain versions, quick start, and per-platform build commands
Development	Developer notes, contributing guidelines, and the pull request process

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 Development 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.

Moonfin is an independent project and is not affiliated with the Jellyfin or Emby projects. ← Back to main Moonfin project