What Moonfin is, and what it isn't
Moonfin is a media client for Jellyfin and Emby servers, built with Flutter. One shared codebase powers phones and tablets, Windows, macOS and Linux, Android TV, Fire TV, Apple TV, and the browser. The project is also upfront about its standing. It says it is not affiliated with the Jellyfin project and is an independent set of clients focused on enhanced user experiences. Don't mistake it for an official Jellyfin app.
The headline claim, "the only Jellyfin client" built for homelabbers, is the author's opinion. Nothing in the documentation can verify "only". The more useful question is whether the feature list holds up, and mostly it does, with caveats.
Windows install and requirements
For Windows readers, the practical details are simple. The installation page lists winget or the installer, with the command winget install Moonfin.Moonfin, and gives Windows 10 as the minimum version. The documentation also says that winget upgrade Moonfin.Moonfin updates an existing install.
If you prefer a downloaded installer, there are two builds. One is for normal PCs and one is for Windows on ARM (Snapdragon laptops). Not sure which you have? Open Settings > System > About and read the System type line.
The project's installation guide also warns about a SmartScreen prompt. It says a blue "Windows protected your PC" box may appear on a freshly released version. The installer is signed, but you may need to choose More info, then Run anyway.
On the server side, the project's pages quote a floor of Jellyfin 10.8 or newer and Emby 4.8 or newer for the client. Check the Moonbase requirement separately, though. Moonbase's own page says it needs Jellyfin 10.10 or newer, or Emby 4.8 or newer. A Jellyfin 10.8 or 10.9 server may run the client but not the plugin.
Admin tools inside the client
Moonfin's feature guide lists an integrated administration area. It has views for settings, users, libraries, logs, devices, and analytics. It also has an Identify dialog for matching items to the correct metadata. The user guide places it under Settings > Administration. It requires a server-admin account, so it doesn't let a normal viewer bypass permissions.
Two kinds of logs are easy to confuse:
- Server logs are Jellyfin's or Emby's own logs, shown in the admin panel. They need admin rights and are useful for diagnosing transcoding decisions.
- Client logs are Moonfin's own diagnostics. They are off by default and held in memory only, in a buffer of the most recent 2,000 entries. Turn logging on first, reproduce the problem, then copy the report.
The client log reports can also be uploaded to your own server. Jellyfin accepts them out of the box. Emby needs the Moonfin plugin with client log upload enabled.
Multiple servers in one library
The multi-server feature works as described. The features guide says Continue Watching, Next Up, and Latest rows pull from every connected server. When several servers are active, libraries appear as "Library Name (Server Name)". Search covers every signed-in server and labels each result with its server. That suits a Jellyfin box plus an Emby NAS. It does require each server to be reachable and you to have an account on each.
Moonbase: the line between client and server
The article's most important detail is that several headline features depend on Moonbase. Moonbase is a server plugin for Jellyfin and Emby. It syncs settings across devices, hosts the Moonfin web app on your server, adds extra rating sources, connects your library to Seerr, and gives admins server-wide defaults and tools.
The project describes it as strongly recommended for all users and required for Seerr. The client itself runs against a stock server, so the plugin is not mandatory for basic use.
| Feature | Needs Moonbase? |
|---|---|
| Browsing and playing media | No |
| Multi-server unified library | No |
| Seerr discovery and requests | Yes |
| Settings and theme sync across devices | Yes |
| Hosted Moonfin web app | Yes |
| Retro game libraries | Yes |
Seerr integration is therefore not a client-only feature. A server admin has to install and configure the plugin. The project describes its Seerr support as a proxy, so Moonfin doesn't supply a Seerr service or any media.
For Jellyfin, Moonbase installs through the dashboard: add a plugin repository under Administration > Plugins > Repositories, install Moonbase from the catalog, and restart Jellyfin. Moonbase's page also lists a manual route that drops the plugin into the plugins folder. On a Windows server, that is %ProgramData%\Jellyfin\Server\plugins\Moonfin\.
Retro games: bigger than a novelty, with limits
The game feature is more developed than a gimmick, and the documentation is clear that the server holds the library. One user writeup notes the server only sends the ROM file and save data, while the emulation runs locally on the playing device. That differs from game streaming tools like Moonlight and Sunshine, so there is no server-side video encoding to worry about.
Platform support is uneven, and the article's "wide range of systems" needs a qualifier:
- Windows, macOS, and Linux can browse and play game libraries.
- Android, Windows, and Linux download emulator cores on demand. macOS ships all of them in the app.
- iOS and Apple TV ship a fixed set of six cores. The documentation says Apple's App Store forbids downloading executable code.
- N64, PSP, and Nintendo DS need just-in-time compilation. That limits them to Android and desktop.
- The web version plays through EmulatorJS only.
Moonfin states it doesn't provide or distribute games or BIOS files. You assemble the library on your own server and are responsible for holding the rights to anything you put there.
Playback engines and transcoding
Moonfin uses different playback engines on different platforms. For Windows and Linux that means libmpv. Apple platforms use AetherEngine, and Android and Android TV use Media3/ExoPlayer. The goal is more direct play, which means less work for a modest server.
Be careful with the claim that this reduces server load. A better client decoder can avoid unnecessary transcoding. Whether a given file direct-plays still depends on its codecs, container, subtitles, and the playing device. The project's README says Windows can send HDR to the display untouched. That is a specific Windows benefit, though not a guarantee for every file.
Windows users get a power-user option from libmpv. Moonfin can load your own mpv.conf. The setting is under Settings > Playback & SyncPlay > Advanced Options, where you turn on Enable Custom mpv.conf. The documented default Windows location is C:\Users\YourName\AppData\Roaming\org.moonfin\Moonfin\mpv.conf.
Some rules differ from standalone mpv, according to Moonfin's own wiki:
- Don't put quotes around values.
- Profile headers are ignored, though the lines under them still apply.
- Shaders must be on a single
glsl-shaders=line, separated by semicolons on Windows. - Files over 256 KB are rejected.
- Script execution and
includeorprofileoptions are blocked for security.
Lower-level settings sit behind an "unsafe advanced" switch. The wiki warns that a wrong value, such as a bad GPU API choice, can black out playback. On Windows, Shift+I during playback opens mpv's statistics overlay, which shows whether your settings took effect.
Verdict
The documentation backs up the claim of broad capability. Moonfin combines in-client administration, multi-server browsing, optional Seerr requests, and an unusually deep Windows playback setup. The caveats are real, though. Several of the best features need a server plugin. Platform support is uneven, especially for games. The effect on transcoding depends on your media and devices.
Before installing, confirm your server version against Moonbase's requirement. Install the plugin only if you want Seerr, synced settings, the web app, or game libraries. Use an admin account if you want the in-client administration panel.
References
- Moonfin is the only Jellyfin client that feels like it's actually made for homelabbers How-To Geek · 2026-10-25T18:00:17+00:00
- Installation · Moonfin-Client/Moonfin-Core Wiki · GitHub github.com
- github.com github.com