Skip to content

User Guide

RadicalMuffinMan edited this page Nov 20, 2026 · 18 revisions

User Guide

How to use Moonfin day to day: the player on touch, remote and keyboard, Live TV, casting, requests, downloads, Kids Mode, and making the app look the way you want. For the first-time setup see Getting Started.

Every setting mentioned here can also be found by typing its name into the search box at the top of Settings. Many settings also show a live preview of the screen they change, beside the list on TV and desktop and above it on a phone, so you can see a choice before you save it.

The player

On a phone or tablet

Do this What happens
Tap the video Show or hide the controls
Double tap the right half Skip forward (30 seconds by default)
Double tap the left half Skip back (10 seconds by default)
Slide up or down on the left half Screen brightness
Slide up or down on the right half Volume
Press and hold the picture while the controls are hidden Play at 2x speed while held, back to normal when you let go. Not during Live TV, SyncPlay or a watch party
Tap the lock icon Lock the controls so a stray touch does nothing. Long press the lock to unlock

The skip amounts are under Playback > Player > Skip Forward Length and Skip Back Length. The swipes can be turned off there too (Volume and Brightness Swipes), and Invert Gesture Indicators draws the brightness and volume indicators on the other side from your swipe, so your thumb doesn't cover them.

With a TV remote

Button What happens
Left / Right Skip back or forward by the skip length. Keep pressing and the jumps get bigger. Hold to seek in steps that grow from the skip length to 30, 60 and 180 seconds, with a preview of where you'll land
Up / Down Show the controls and focus the progress bar
OK / Select Play or pause when the controls are hidden, otherwise activates the highlighted button
Play/Pause Play or pause
Rewind / Fast forward Skip back or forward
Hold Pause (remotes with a separate pause button) Play at 2x speed while held, back to normal on release
Next / Previous track Next or previous episode in the queue
Back Hide the controls first, then leave the player
Menu (Apple TV) Same as Back

On Apple TV, Playback > Player > Allow Clickpad Seeking picks when Left, Right and swipes on the Siri Remote clickpad seek: Always, When controls are showing, or Only while paused. When seeking isn't allowed, the first click or swipe only brings up the controls.

On a computer keyboard

Key Action
Space or K Play or pause. Hold Space to play at 2x until you let go, except during Live TV, SyncPlay or a watch party
Left Arrow or J Skip back (default 10 seconds). Hold for bigger jumps
Right Arrow or L Skip forward (default 30 seconds). Hold for bigger jumps
Up / Down Arrow Volume up or down
M Mute or unmute
F Toggle fullscreen
C Subtitles off, or put the last track back on. With nothing to put back, the subtitle picker opens
I Show the stream information overlay (codec, bitrate, resolution)
Shift+I mpv statistics, on Windows
, and . Step the playback speed down or up
H Exit playback
Shift+N / Shift+P Next or previous episode in the queue. A few seconds in, Shift+P restarts the episode instead
S Skip the intro or credits while the skip button is showing
Escape Exit fullscreen first, then exit playback
Backspace or Delete Hide one layer at a time: the Next Up card and skip prompts, then open panels, then the controls. A right-click on the video does the same
B Look for black bars again, while Crop Black Bars is on, and say whether it found any
Enter Skip the intro or credits while the skip button is showing, otherwise show the controls if hidden, or play and pause if visible
Media keys Play and pause, stop, next or previous item, and rewind or fast forward by the skip length
? or F1 Show the keyboard shortcuts without leaving the player

With a mouse, a click on the video plays or pauses, and a double click toggles fullscreen.

App-wide: Escape or Backspace goes back (or home when there's nothing to go back to), Enter activates the focused item, F11 or Alt+Enter toggles fullscreen, Ctrl+Q quits, and ? or F1 lists the shortcuts that work on the screen you're on. On a computer the full list, including the book and comic reader keys, is also under Settings > About > Keyboard shortcuts.

Changing the audio language or subtitles

  • In the player, use the Audio Track and Subtitle Track buttons.
  • Before pressing Play, the movie or episode page also lets you choose the tracks, handy on a TV.
  • If audio or subtitles are slightly out of step, the track pickers end with an Audio Delay or Subtitle Delay row, with minus, Reset and plus in 100 ms steps, so you can line it up while watching. Audio Delay opens a slim bar at the bottom of the screen. Subtitle Delay opens at the top, out of the way of the subtitles, with a timeline of the track's lines sliding past the playhead.
  • While a text subtitle plays, the subtitle menu also has Subtitle Size and Vertical Offset under the track list.
  • To show two subtitles at once, for example to learn a language, turn on Playback > Subtitles > Secondary Subtitles. The subtitle menu then asks for the primary or secondary track first. The secondary has to be an SRT or WebVTT track and has its own delay, size, color and spacing, and Preferred Secondary Subtitle Language puts a language at the top of its list.
  • The default language and whether subtitles show at all are under Playback > Subtitles. Size, position and colors are under Subtitle Customization there. The text, its outline and the background each pick from fifteen colors, and Separate HDR Style gives HDR films a dimmer style of their own. Bold Text, Text Stroke Width, Text Shadow and Font, a choice of 10 Google Fonts that downloads the first time you pick one, are there too.

Speed, skipping intros, and what plays next

  • Playback speed has its own button in the player. On a keyboard use , and . or hold Space for a quick 2x, and on a TV hold Pause.
  • Skip Intro and Skip Credits buttons appear when the server knows where those segments are. Under Playback > Skipping & Autoplay you can make each segment type skip on its own, and choose whether the buttons hide themselves.
  • Next Up counts down at the end of an episode. The same Skipping & Autoplay screen controls autoplay and the still-watching check.
  • Cinema Mode plays trailers or pre-rolls before a film, when the server provides them. Cinema Mode Skip Button, on the same screen and off by default, shows a Skip button for ten seconds on each pre-roll longer than that.
  • Episodes, a button in the player, opens season tabs with every episode of the season you're watching. Picking one plays it and queues the rest of its season.

Rearranging the player

Playback > Player > Player Buttons lets you show, hide and reorder every button in the player, separately per device type. Its Play buttons option moves play, skip and seek into the bottom bar on phones, tablets and desktop. Progress Bar Time sets what the six time slots around the progress bar show: time elapsed, total duration, time remaining, the clock time the film ends at, the current time, or nothing.

Hide Controls After, on the same screen, sets how long the controls stay up after your last press: 1, 3 or 5 seconds, with 5 the default. Dim Controls in HDR dims them by up to 70% while HDR plays, since white looks far brighter next to HDR video. Show Description on Pause shows the title's description as soon as you pause, up to 8 lines.

On iPhone, iPad and Apple TV, Playback > Player > Video player picks Standard, the player with Moonfin's own controls, or Native Apple style, the system player.

The mini player on a computer

On macOS, Windows and Linux, the Minimize player button in the player's top bar shrinks the video into a bar along the bottom of the app, and it keeps playing while you browse. The bar has a seek bar, the play controls, the audio and subtitle pickers, and volume. Click the thumbnail to open the full player again.

In a browser, the Picture-in-picture button in the player pops the video out into the browser's floating window, and the page shows Playing in picture-in-picture until you bring it back.

Watching Live TV

Open Live TV from its library tile, or turn on Appearance > Navigation Bar > Show Live TV Button to put it in the navigation bar. It has the Guide, Recordings and Schedule.

  • The guide opens on the channel you watched last. Pick a program to watch it or record it.
  • Record Series asks whether to record All Episodes, Episodes Not Already Recorded or New Episodes Only. Series Settings changes that later, from the guide, the player or the Series Recordings tab.
  • While a channel plays, the record button in the player records the program that's airing or its whole series, and turns red while it records.
  • On channels whose stream keeps at least a minute of rewind window, the player gets Seek back, Seek forward and Jump to Live, with a timeline showing how far behind live you are. That works with Media3 on Android and on iPhone, iPad, Mac and Apple TV. A tuner's raw stream keeps no window, so those channels can't rewind.
  • On a TV remote, Rewind and Fast forward page up and down the channel list a screenful at a time.
  • If you've wandered off through the guide, Back first jumps you to that channel and the current time, then moves to the filters, and then leaves.
  • On a TV remote with them, Guide opens the guide, DVR opens Recordings, and Channel Up and Channel Down follow the guide's order and filter. For remotes like the NVIDIA Shield's that keep those buttons for themselves, a remapper such as Button Mapper can open moonfin://live-tv/guide and moonfin://live-tv/recordings. Deep Links lists every link Moonfin answers.

Changing channels on a TV

While a channel plays, press Up, or pick the Channels button next to Guide in the player controls. A strip of channel cards opens along the bottom, showing what's on each one now.

  • Left and right move through the channels in the same order as the guide, and wrap around from the last channel to the first.
  • OK tunes to the highlighted channel. Back closes the strip.
  • It closes by itself after two minutes without a press.

The Guide button opens the full guide over the picture instead.

When a channel stalls

If the picture freezes for a few seconds, or a channel shows nothing for half a minute after you tune it, Moonfin tries to get it back on its own, up to three times, and shows Reconnecting… (1 of 3) while it works. If that doesn't bring it back, the tuner is freed and a Failed to play card with Retry stays up until you pick something, with the guide and channel list still working behind it. On Apple TV the reconnecting happens quietly, without the message.

Casting and playing on another device

  1. Open a movie or episode and tap the Cast button, or tap it inside the player.
  2. Pick a device. Moonfin lists Google Cast devices (Android and desktop), AirPlay devices (iPhone, iPad, Mac), DLNA receivers, and under Remote Playback any other Jellyfin app signed in to your server.
  3. A small player bar controls what's playing on the other screen: play, pause, seek, volume, and Stop.

Remote Control

You can also steer another Jellyfin app on your network without playing anything from your device:

  1. Tap your avatar in the top toolbar and choose Remote Control. With the bottom bar on a phone or tablet, it's a tile under You.
  2. Pick a device. Each shows its name, what it's playing, and a device type icon.
  3. Send it commands: play something on it, pause, stop, change volume, or seek.
  4. Move around its menus with the round pad, OK, Back and Home. They work even when nothing is playing, and each one only shows if the other device supports it.
  5. Tap Search to open Search on the other device and type with your phone's own keyboard. On another Moonfin app the search updates as you type, and Done closes the keyboard. Other apps get the whole text at once when you tap Send.
Advanced: what has to be true for this to work
  • Works with desktop clients, mobile apps, web players, smart TV apps, and other Jellyfin-compatible players.
  • The target device must be registered with your Jellyfin server, online, and connected to the same server instance.
  • You must have playback permission for the content.

It works the other way round too. Moonfin shows up in the remote control list of other Jellyfin apps, and from there they can pause it, seek, change or mute the volume, switch audio and subtitle tracks, move around the menus with the direction buttons, and type a search. That works on every device Moonfin runs on, not just TVs, and on a computer they can also toggle fullscreen.

On an Android phone, Remote playback notification under Settings > General, off by default, shows media controls in the notification shade while another device on your account is playing. Tapping the notification opens Remote Control on that device.

Watching together (Watch Parties)

A watch party plays the same movie or episode for everyone in it, each on their own device, and keeps you all in step. Jellyfin and Emby servers need Moonbase 3.1.0, and Plex servers need Moonbase for Plex. Without it, Jellyfin servers use SyncPlay instead. Silo has watch parties of its own, see Watch parties on Silo.

Everything is under Settings > Playback > Watch Parties. The Watch Parties switch at the top is on by default, unless you'd turned SyncPlay off before. Open Watch Parties there opens the Watch Parties screen, and Watch Parties button under Settings > Appearance > Navigation Bar puts it in the navigation.

On iPhone, iPad and Apple TV, parties work in both video players, Standard and Native Apple style.

Starting a party

  1. Open the Watch Parties screen and pick Start a watch party. Or open a movie or show and pick Watch with group, which starts a party with it. A show or season stands for its next episode.
  2. To pick or change what everyone watches, open a title and pick Watch with group.
  3. Send the invite. On a phone or computer, Copy invite link copies a link to paste in any chat. A TV shows a QR code under Send the invite: scan it with your phone to get the link, and send it from there. Or just share the room code, which looks like K7Q 29M.
  4. When everyone shows Ready, pick Start for everyone. If you watched part of it before, Resume at starts everyone from where you left off, and Start from the beginning doesn't.

Playback waits for everyone's player, 10 seconds at most, then counts down 3, 2, 1.

To let the room choose, turn on Let everyone vote on movies under Room settings in the lobby. Add movies with Search movies, or with Watch with group on a movie's page. Everyone votes, and you play the one you want. Episodes are always the host's pick.

Joining a party

  • From the list. The Watch Parties screen lists the parties on your server that you can watch. Pick one to join. If it has a PIN, you're asked for it. On Jellyfin, SyncPlay groups show in the same list, each labeled Watch Party or SyncPlay.
  • From Home. While parties are running, a Watch Parties row leads the Home screen, ending with a Start a watch party card.
  • With a code. Type it into Room code or invite link and pick Join. On a TV it's under Join with a code. Pasting the whole invite link works too.
  • With an invite link. The link opens a page with Open in Moonfin. On a phone or computer with Moonfin, that opens Moonfin straight into the party. If the party is on another server you've added, Moonfin switches to it first, and if you haven't added that server yet, it offers to.
  • From a party alert. See Party alerts.

You only see, and can only join, parties for something you're allowed to play.

During the party

  • A note at the top names whoever paused, resumed, skipped, joined or left.
  • The Watch Party button in the player controls opens the party. On a computer it's a side panel with Chat and People tabs, and on a phone the same tabs come up in a sheet. On a TV the sheet has the reactions, the quick replies Haha, No way, Pause please, Brb and Again!, Type for your own message, and then the people.
  • Reactions (Love, Haha, Wow, Sad, Fire and Popcorn) float up over the video for everyone.
  • New messages show over the video for a few seconds. Turn that off with Show chat over the video under Settings > Playback > Watch Parties.
  • Hold a phone upright and the chat sits under the video, with the reactions and a box to type in.
  • People shows how each person is doing: In sync, Catching up, Buffering or Not watching.
  • Only the host can play, pause and skip, unless the host lets everyone. A guest who tries sees "Only the host can control playback."

Host controls

  • Next to each person in the people list are Make host and Remove.
  • Room settings has Everyone can control playback, so anyone can play, pause and skip, and Room PIN, 4 to 8 digits asked of anyone who joins.
  • Leave hands the room to the person who joined earliest, and it names them. End for everyone closes the room.

Guests have Leave, and can come back from the list while the party is still on.

Party alerts

Turn on Party alerts under Settings > Playback > Watch Parties to hear when someone on your server starts a party you can watch. While Moonfin is on Home, a phone shows a banner you can tap to join, a computer shows one with Join and Not Now, and a TV shows one for 8 seconds without taking focus and puts the party first in the Watch Parties row. On Jellyfin and Emby, phones also get a push notification while Moonfin isn't open, and tapping it opens the party.

SyncPlay on Jellyfin

On Jellyfin, Start parties with under Settings > Playback > Watch Parties picks whether Start a watch party makes a Watch Party or a SyncPlay group. SyncPlay is Jellyfin's own, so friends on other Jellyfin apps can join it, while a watch party brings chat, reactions and voting. You can join rooms of both kinds either way. The sync correction settings on the same screen tune how this device keeps up, and they only show on Jellyfin.

Watch parties on Silo

On a Silo server the same Watch Parties button opens Silo's own rooms, with no Moonbase needed. Rooms have codes, a lobby, voting and host controls, and the host can resume from the earliest point anyone reached. With Moonbase for Silo installed, the host can also pick subtitles for everyone, and members show their avatars. Chat, reactions, the list of open rooms and the Watch Parties row on Home aren't available on Silo.

Requesting movies and shows you don't have (Seerr)

This needs Seerr connected in the Moonbase server plugin by whoever runs your server. Then:

  1. Go to Settings > Integrations > Seerr and sign in. Jellyfin as the account type uses your normal server login.
  2. Search for something that isn't in your library. It opens the same page as anything you already have, with a Request button (and Request 4K if your server offers it).
  3. Under Requests you can see the status of everything you asked for, with a progress bar while it downloads, and Cancel Request if you change your mind. A stuck download says why, and admins can Get a different release. Before anything downloads, the request says what Radarr or Sonarr is waiting on, such as Searching indexers, Not found yet or the date it comes out.

On Plex, Moonbase for Plex signs each person in to Seerr with their own Plex account, as long as Seerr uses Plex sign-in. On Silo there's nothing to set up: requests, your watchlist and the admin request queue use Silo's own requests instead of Seerr.

The same Seerr screen in Settings picks the rows on Seerr's Discover page and turns on notifications when a request is approved or arrives. Under those switches, Server Push says whether your server can send push notifications, Device Push says whether this phone or tablet is registered for them, and Send Test Notification sends one to check, which needs Moonbase 3.1.1. Seerr rows for the home screen (Trending, Popular, Upcoming, Recently Added, and any sliders your admin added to Seerr's own Discover page) are under Settings > Appearance > Home Screen > Seerr Rows.

The calendar

This needs Moonbase 3.1.0 with Seerr linked to Sonarr or Radarr, or Moonbase for Plex with Sonarr or Radarr set in its admin page, set up by whoever runs your server. Then:

  1. Open Calendar from the navigation, or from You on a phone. It opens in the style picked under Settings > Integrations > Calendar > Calendar style.
  2. In Agenda, switch between Upcoming and Recently aired. On TV and desktop the right half of the screen previews whatever is selected, with Play when it's on the server, Go to Series or Movie details, and Request for titles you don't have. Selecting a row opens it, or plays it if Selecting an item is set to Play when in library.
  3. Full calendar, or the calendar icon at the top on a phone, shows the whole month. Move to a day to see what's on it, and press OK on a day with entries to move into them. Moving onto one of the greyed days from the month before or after switches to that month, and the arrows at the top do the same.
  4. On a phone or tablet, tap the bell on anything that isn't in your library yet, and you'll get a notification when it arrives. Tap it again to cancel.

Everything else, like which entries show, Spoiler safe, My shows and the first day of the week, is under Settings > Integrations > Calendar, and it syncs to your other devices of the same kind. Show Calendar Button is under Settings > Appearance > Navigation Bar. The See All card at the end of the Upcoming rows is under Settings > Appearance > Home Screen > Upcoming Calendars, and Next air date at the end is under Settings > Playback > Skipping & Autoplay. Date Format under Settings > General > Clock switches calendar and release dates between Locale Default, Month / Day and Day / Month.

Searching in plain words (Smart Search)

When your server admin has turned on Smart Search in the Moonbase plugin, you can search with a sentence instead of a title, like "90s movie about a kid pulled into a board game". A Smart Search row then leads the results. With a TMDB key and Seerr on the server, a second row adds matching titles you don't have yet, ready to request. It only kicks in for two or more words, so typing a title works the same as before.

Downloads for offline viewing

Open a movie, episode, album or book and tap Download. Seasons and albums have Download All. Once you've saved something, a Downloads entry shows up in the navigation. It lists everything you saved, has an Active Downloads tab for what's still coming in, and plays with the same controls as streaming. Full details, including quality presets and where the files go, are on the Downloads page.

On Android TV the download buttons are off until you turn on Settings > Storage > Enable Offline Downloads.

New episodes on their own

To keep a show topped up, open the series and choose Auto-download new episodes from its download menu. Moonfin then fetches new episodes as they arrive. The rules live in the Automatic downloads section of Settings > Storage:

  • Keep Unwatched Episodes sets how many unwatched episodes of each show stay downloaded.
  • Delete Downloaded Episodes removes the ones you've watched, right away, a day later, a week later, or never.
  • Check in the Background lets the system look for new episodes while Moonfin is closed. Check Now looks straight away.
  • Followed series lists every show you follow, with Stop following on each.

To have the next episodes of whatever you're watching ready without following anything, turn on Download Next Episodes in the Smart downloads section of the same screen, and pick how many with Episodes to Keep Downloaded. Each one is deleted once it's watched. Smart downloads and auto-downloads are on phones and tablets only.

Remove Watched Downloads, under Storage, does the same clean-up for movies and episodes you downloaded yourself. It's set to Never until you change it. With Ask me, finishing a download asks whether to Delete it, Keep it for good, or ask again next time with Not Now.

Downloading subtitles

  1. Open any movie or episode page.
  2. Find the Subtitles section.
  3. Tap the download icon next to the track you want.

Downloaded subtitles are saved with your media and work offline. This needs the OpenSubtitles plugin on the server. Settings > Playback > Subtitles > Subtitle Download Languages searches up to five languages at once, with the results grouped by language. Auto searches one language picked from your default subtitle language or the video.

Advanced: telling similar tracks apart

Each search result carries badges under its name saying what it actually is: SDH, AI Translated, Machine Translated, and the frame rate it was timed against. That lets you tell two similarly named tracks apart before downloading either. Synchronized timing is preserved during download, and you can pick your preferred format (SRT, ASS, VTT) from what your server offers.

Making the app look the way you want

Everything below is under Settings > Appearance.

You want to change Go to
Colors and overall look App Theme. The Theme Store has community themes, Saved Themes keeps the ones you liked, and OLED Mode gives true blacks
How big everything is UI Scaling: Small, Medium, Large, Extra Large, Grandparents, or Great-Grandparents for the biggest text and buttons
Where the navigation bar sits and what's on it Navigation Bar: Left Sidebar, Top Bar or Bottom Bar (the default on a phone or tablet), plus which buttons show, such as Downloads and admin messages. Show Libraries Individually gives each library its own button. On a phone or tablet the Bottom Bar comes as Dock, Split or Strip, and Bottom Bar Tabs pins up to three tabs between Home and You. Everything else is in the You menu
The big banner at the top of Home Home Screen > Media Bar: six styles or off, the Source it draws from, new release labels, Trailer Preview (off by default), trailer sound, and Peek Home Rows to show the top of your first row under it
Which rows are on Home and in what order Home Screen > Rows. Row Type picks Classic, Modern or Carousel, which adds a large details panel under each row and is the default on TV. On Classic rows, Image Type per Row picks posters or thumbnails per row
The ratings shown on Home Home Screen > Ratings for the rows, and Media Bar > Ratings for the banner. They're separate from the Details Page ratings
What the Apple TV Top Shelf shows Home Screen > Top Shelf: your latest media, or a Moonfin banner
How a movie or show page is laid out Details Page > Details Screen Style (see below). Action Buttons picks which buttons appear there, Metadata Row what the line of details under the title shows, and Sections hides whole parts of the page, such as chapters or extras
The background art Home Screen Backdrop under Home Screen, Details Screen Backdrop under Details Page, and Library Backdrops under Libraries
How library pages look Libraries > Video Library Style (Classic, Modern or Docked), Music Library Style and Book Library Style
Which libraries show up at all Libraries > Library Visibility
The order of your libraries Libraries > Library Order. It's saved to your server account, so other apps you sign in to follow it too
The names under library posters Libraries > Titles Under Posters. Turn it off for just the artwork. Hide Watch Progress and Hide Unwatched Count there take the progress bar and episode count off library posters
Labels like 4K or HDR on posters Poster Labels, when your server admin has set labels up in the Moonbase plugin
A screensaver, seasonal effects, the loading animation Their own entries under Appearance. The screensaver is on TVs only, and its Let TV Sleep After hands the TV back to its own screensaver and sleep after 15 minutes to 2 hours of no use. Seasonal effects have a Density setting for how much falls at once, and on TV and desktop a Focus Follower switch for the holiday piece that follows what you select on Home
Theme music Details Page > Theme Music

Moonbase users get most of these synced between their devices.

Detail screen styles

Style What you get
Classic Everything centered in one stack
Modern Cinematic, with tabs for cast and extras. This is the default on phones and tablets
Spotlight A big hero image with Play and a few buttons up front, and the rest under More Actions. Cast, chapters, seasons and similar titles sit on summary cards that open a pop-up grid
Nouveau Full screen, with every section stacked down the page instead of behind tabs
Minimalist Artwork, one play button and the episodes. It covers movies, shows, seasons, episodes, videos and collections, and anything else, such as a person or an album, opens in Spotlight
Stage The poster up front, with Play under it and the details beside it
Premiere The title centered over a full-screen backdrop, with the buttons and ratings under it and every other section further down the page
Quick Look A drawer over the screen you were on, or a sheet on a phone, with Play and the basics. Open full page takes you to Modern
Frost The title in a glass window over its blurred art, with tabs under the buttons for Overview, Episodes, Cast & Crew, Extras, More Like This and Details. This is the default on TV and desktop

Spotlight and Minimalist show playlists in the Modern layout. Stage, Premiere, Quick Look and Frost cover movies, shows, seasons, episodes, videos and collections, and open people, albums and books in Modern.

The ratings on the page show as plain text unless you turn on Details Page > Ratings > Rating Badges.

Parental controls and Kids Mode

Under Settings > Account:

  • PIN Code: Enable PIN Code, then choose whether a PIN is needed to open your account at all. Change or remove it here too. With the Moonbase plugin, the PIN follows you to your other devices, and each device keeps a copy for when the server can't be reached.
  • Parental Controls: tick a rating to block it and everything stronger. Blocking PG-13, for example, also blocks TV-14 at the same level and R, TV-MA and NC-17 above it. Ratings Moonfin can't place on that scale are listed under Only blocks itself and block just that one rating.
  • Kids Mode: see below.

A blocked title is hidden everywhere: home rows, the media bar, search, libraries, folders, favorites and suggestions. Episodes go by their show's rating. If you reach one anyway, say through a link, you get a padlock and "This isn't available" instead of the page, and it won't play. Titles with no rating at all are never hidden. Blocked ratings are kept per server and per user on this device, and they don't sync to your other devices.

Kids Mode

Kids Mode strips Moonfin back to what a child needs and puts a PIN on the way out.

  1. Go to Settings > Account > Kids Mode.
  2. Pick a PIN. It's separate from your sign-in PIN, and you choose a fresh one every time Kids Mode goes on.
  3. Settings shrinks to a single entry, Exit Kids Mode. Pick it and enter the PIN to get the full app back.

While it's on:

  • The navigation drops Seerr, Live TV, Watch Parties and the libraries button, and nothing in Settings is reachable apart from the way out.
  • Home keeps your library tiles, the latest additions, and Continue Watching and Next Up merged into one row.
  • Search leaves out Seerr results.
  • Every movie or show opens in the Minimalist style, without ratings, the description, technical details, or buttons to download, delete or request. Trailers play inside the app instead of opening a browser or YouTube.
  • After five wrong PINs, each further guess has to wait, up to 15 minutes.

Kids Mode is off by default, and it stays on the device you turned it on for rather than syncing. It doesn't hide anything by rating on its own, and Continue Watching still shows whatever anyone on the same account started. Block ratings under Parental Controls as well, or give each child their own server user, to keep grown-up titles out of reach on a shared TV.

More than one server

Tap your avatar > Add Server. Moonfin shows all libraries together, each labeled with its server, and Continue Watching and Next Up pull from every server. Merge Movie and TV Show Libraries, under Appearance > Libraries, goes further and shows one Movies and one TV Shows library for all your servers, Plex and Silo included, with a title several servers hold listed once. Server management, including removing one, is in the same avatar menu.

While you're signed in to Silo, Approve a sign-in in the avatar menu, or under You with the bottom bar on a phone, takes the code another device shows and signs that device in without a password.

Typing on a TV

Settings > General > Keyboard Style picks how it looks: Native is the TV's own keyboard, Classic is the original Moonfin keyboard, Glass is a frosted panel with bigger keys, and Docked, the default, fills the bottom of the screen and shows what you type above it. A key inside the keyboard switches style on the spot.

Moonfin's own keyboard has a few tools beyond the letter grid:

  • Caret keys (‹ and ›) move the cursor through the text, so you can fix a typo in place. Holding OK keeps the caret walking.
  • Backspace: holding OK keeps deleting. On touch screens, a long press clears the whole field.
  • Paste key (clipboard icon) inserts the clipboard at the cursor. Handy for server addresses or passwords copied from a password manager.
  • Accents and extra symbols: keys marked with a small dot hold more characters. Hold OK on the key (or long press on touch), then pick with the direction keys.
  • Suggestion chips above the keys offer recent searches, previously used usernames at sign-in, and known server addresses. Passwords never show suggestions.
  • Number pad: numeric fields such as PINs and ports get a large phone-style pad.
  • Layouts follow the app language, with AZERTY for French and QWERTZ for German, Czech, Slovak, Hungarian, Croatian, and Slovenian.
  • System keyboard key hands the field to the platform keyboard, for voice input or other languages.

Or skip typing altogether: use Quick Connect to sign in (see Getting Started), and the Paste key for addresses.

Power user corner

  • Custom mpv settings for shaders and scaling on Windows, Linux and Android: Custom mpv Configuration.
  • SyncPlay, Jellyfin's own way of watching together, now lives with Watch Parties under Playback > Watch Parties. See Watching together.
  • The admin panel (Settings > Administration) manages users, libraries, devices and logs without leaving the app, if your account is a server admin. It's on phones, tablets, desktop and web, for Jellyfin and for Emby 4.9 and later.
  • Achievement Badges: if your Jellyfin server runs the Achievement Badges plugin, Settings > Integrations > Achievement Badges shows your badges, rank, quests, power-ups and the leaderboard. Unlock notifications above Badges shows a banner when you earn one.
  • Friends and chat: when the same plugin has friends turned on, Achievement Badges > Friends shows who's online and what they're watching, handles friend requests, and has one to one and group chats. Show Friends Button under Appearance > Navigation Bar puts it in the navigation with a count of requests and unread messages.
  • A seasonal row: Settings > Appearance > Home Screen > Seasonal Row sets up a Home row of holiday movies around New Year's, Valentine's Day, Easter, Pride, Halloween, Thanksgiving, Christmas, Lunar New Year and Diwali, with Seerr suggestions when Seerr is set up. Each holiday can be unticked, and the country follows your device unless you pick one. Show All Year keeps a row up outside the holiday dates too, picking a different ticked holiday each day. It needs the Moonbase plugin, and the row itself is listed under Home Screen > Rows whenever your server can fill it.
  • After Hours: press Version under Settings > About seven times to open a hidden arcade of five small games made from Moonfin, playable with a remote, a keyboard or touch. Each game keeps a top 3, on your server with Moonbase 3.1.0 or on the device otherwise.

Clone this wiki locally