Skip to content

Getting Started

RadicalMuffinMan edited this page Nov 19, 2026 · 7 revisions

Getting Started

You've installed Moonfin. This page gets you from the first screen to watching something, in about five minutes. If you haven't installed it yet, see Installation.

Have these ready

  1. A Jellyfin, Emby, Plex or Silo server that is switched on. It can be your own PC or NAS, or one a friend or family member shares with you. Jellyfin 10.8 or newer and Emby 4.8 or newer both work. For Plex you sign in with your Plex account instead of typing an address, so you can skip the next item.
  2. The server's address. It's the same thing you would type in a web browser to reach it. Examples:
    • http://192.168.1.20:8096 (a server on your home network)
    • http://mynas:8096 (a home server by name)
    • https://jellyfin.example.com (a server reachable from anywhere)
  3. A username and password on that server. If someone else runs it, ask them. If it's yours, it's the account you made when setting the server up.

Don't know the address? On the computer that runs the server, open the Jellyfin or Emby web page and copy what's in the browser's address bar, up to the first single slash. Or ask the person who runs it.

Step 1: Add your server

  1. Open Moonfin. If a server is on the same Wi-Fi as you, it shows up under Discovered Servers. Tap it and skip to Step 2.
  2. Otherwise tap Add Server. It asks how you'd like to connect: Server Address for Jellyfin, Emby or Silo, Sign in with Plex, or Emby Connect.
  3. For an address, type it.
    • You can leave out http:// and the port. Moonfin tries https and http, and the standard ports 8096 and 8920, on its own.
    • If your server uses a different port, include it, like mynas:8000.
    • For Silo, include Silo's own port: 8090 with Silo's Docker Compose setup, or 8080 without Docker, like mynas:8090. If you enter Silo's Jellyfin-compatible address instead, Moonfin offers to connect to Silo directly. Use Silo gives you Silo's own features, and Keep Jellyfin adds it as a Jellyfin server.
    • A Plex server's address opens Plex sign-in instead.
  4. Tap Connect. Moonfin shows what it's checking, then Server found with the server's name, type and version. Tap Continue.

With Plex: pick Sign in with Plex. Moonfin shows a short code. Go to plex.tv/link on any device and enter it, scan the QR code on a TV, or choose Sign in with a password to use your Plex email or username and password. Your Plex servers are then listed to pick from.

If you get Unable to connect to server, open the same address in the browser on the same device. If the browser can't reach it either, the problem is the address or the network, not Moonfin. See Common Problems.

If Moonfin says the server's certificate isn't trusted, the server uses a self-signed or home-made certificate. When it's a server you or someone you trust runs, press the button under the message to allow it and connect.

If it says this server needs a client certificate (mTLS), press Add client certificate and pick the .p12 or .pfx file the server owner gave you. On a TV, Send from phone shows a QR code so you can pick the file on your phone instead. See Common Problems.

Silo servers on your network show up under Discovered Servers too. The web version can't search your network, so there you always type the address.

Step 2: Sign in

With a username and password: type them and tap Sign In. Emby users also see an Emby Connect option if they use that.

With Quick Connect (Jellyfin only): this saves typing a password with a TV remote.

  1. Tap Quick Connect. Moonfin shows a short code. On a TV, a computer or the web app it also shows a QR code.
  2. On a phone or computer where you are already signed in to the same server, open the Jellyfin web page, click your user icon in the top right, choose Quick Connect, type the code and confirm. Or scan the QR code with a signed-in phone, which opens the approval page with the code filled in. The QR code needs Jellyfin 10.9 or later.
  3. Moonfin signs in by itself within a few seconds.

If it says Quick Connect is disabled, the server admin has to turn it on under Dashboard > General in Jellyfin.

On Silo: sign in with your password, or pick Sign in with a code. Moonfin shows an 8-digit code and a QR code. Scan the QR code with a signed-in phone, which opens Silo's approval page with the code filled in, or enter the code in Silo on a device where you're signed in. If your account has more than one profile, Who's watching? comes up next. A locked profile asks for its PIN, and unticking Remember PIN on this device makes it ask every time the app starts or you switch to it.

Moonfin stays signed in afterwards. To change that, go to Settings > Account > Auto Login.

Step 3: Answer the setup wizard

Right after the first sign-in Moonfin asks how you want it to look. Every choice shows a live preview built from your own library, so pick whatever looks nice. Nothing here is permanent, it all lives under Settings > Appearance later, and Settings > About > Run setup again brings the wizard back. Tap Skip setup to accept the defaults.

Question What it decides
Where should navigation go? Left Sidebar, Top Bar or Bottom Bar. A phone or tablet starts on Bottom Bar
How should the bottom bar look? Only asked on a phone or tablet after picking Bottom Bar. Dock is a floating pill with labels, Split gives Search its own button and shrinks while you scroll, Strip is a full-width bar along the bottom edge
How should the top of your Home screen look? The media bar style: Moonfin, MakD, Bookshelf, Gallery, Banner, Aya, or Off
How should your rows look? Classic (compact, more rows on screen), Modern (larger cards with titles underneath) or Carousel (posters with a large details panel underneath). Carousel is the default on TV
How should a movie or show look when you open it? The detail screen style: Classic (everything centered in one stack), Modern (cinematic, with tabs), Spotlight (hero first, with pop-up cards for cast and extras), Nouveau (full screen, with sections stacked instead of tabs), Minimalist (artwork, one play button and the episodes), Stage (the poster up front with the details beside it), Premiere (the title centered over a full-screen backdrop), Quick Look (a drawer with the basics over the screen you were on) or Frost (the title in a glass window over its blurred art). Frost is the default on TV and desktop, and Modern on phones and tablets
Pick a look A color theme: Moonfin, Neon Pulse, Glass or 8-bit Hero. Under the themes, an optional Playback languages section sets your audio language, whether to prefer the default audio track, your subtitle language and when subtitles show

If your server doesn't have Moonbase yet, the last step also has Add Moonbase to your server, which lists what it adds. A Jellyfin admin can press Install and then Restart Server right there. Anyone else gets a link to the install steps to send to whoever runs the server.

It ends with a short tour of what else is in the app.

Step 4: Find your way around

  • Home shows Continue Watching, Next Up and the latest additions from each library, with the media bar on top.
  • Your libraries (Movies, TV Shows, Music and so on) are in the navigation bar, along with Search.
  • Tap a poster to open its page. From there you can Play, Resume, mark as a Favorite, Download, Cast, watch a Trailer, and see the cast and similar titles.
  • Long-press a poster (hold OK on a remote) for a quick menu with Play and Resume, so something can start without opening it first.
  • Settings is behind the gear icon or your avatar in the top corner. The search box at the top of Settings finds any setting by name and tells you where it lives.
  • On a TV: the direction pad moves, OK selects, Back goes back. The User Guide lists what each button does inside the player.

Step 5: Settings worth a look on day one

You don't have to change any of these. They're the ones people most often want.

If you... Look at
Have an OLED TV or phone Appearance > OLED Mode
Want bigger text and buttons Appearance > UI Scaling. It goes from Small up to Extra Large, and Grandparents and Great-Grandparents are bigger still
Want different rows on the home screen, or a different order Appearance > Home Screen > Rows
Want the skip buttons to jump a different amount Playback > Player > Skip Forward Length and Skip Back Length
Have a soundbar or AV receiver (Android TV, Apple TV) Playback > Audio > Passthrough. Auto is right for most setups
Want bigger or different-looking subtitles Playback > Subtitles > Subtitle Customization
Want two subtitles at once Playback > Subtitles > Secondary Subtitles
Plan to download for offline viewing Storage for quality and location. On Android TV also turn on Enable Offline Downloads at the top of that screen
Share the device with children Account > Kids Mode and Parental Controls. See Parental controls and Kids Mode
Have Seerr on your server Integrations > Seerr, sign in with your Jellyfin account
Use a game controller to move around the menus Appearance > Gamepad Navigation
Type a lot with a TV remote General > Keyboard Style

More than one server

Tap your avatar, then Add Server, and repeat Steps 1 and 2. Moonfin merges the libraries of all your servers into one view, and each library shows the server's name next to it. Continue Watching and Next Up pull from every server. This works with a mix of Jellyfin and Emby servers. 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.

Things that need the server side

Some features only appear once the server has the pieces they need. Ask whoever runs the server if you want them.

  • The Moonbase server plugin (Jellyfin and Emby) adds theme sync between devices, sorting by your personal ratings, retro games, messages from your admin, home row sync, the seasonal holiday row, anime filler and recap markers, poster labels, Smart Search, and the web version of Moonfin. Watch Parties, the Calendar and the Upcoming rows need Moonbase 3.1.0. The JustWatch and TMDB rows, game rows on Home and the full Seerr download status need Moonbase 3.1.1.
  • Seerr (for requesting new movies and shows) is connected in the Moonbase plugin. In Moonfin you then sign in under Integrations > Seerr and get Request buttons on titles you don't have yet.
  • Subtitle downloads need the OpenSubtitles plugin on the server.
  • On a Plex server, Moonbase for Plex, a companion service that runs next to Plex Media Server, brings Settings Sync, MDBList and TMDB ratings, themes, messages from your admin, Seerr, Smart Search, the Calendar with reminders, Watch Parties, similar titles, IMDb, TMDB and custom list rows, anime markers and retro games. Audiobook bookmarks and notes and personal ratings need Jellyfin or Emby, and the admin panel, SyncPlay and Quick Connect aren't available on Plex. Moonfin finds Moonbase for Plex at the Plex server's address on port 32500, and Settings > Account > Settings Sync > Moonbase Address points it somewhere else.
  • On a Silo server, requests and Watch Parties come from Silo itself, with no Seerr or Moonbase needed. Moonbase for Silo, installed from Plugins > Catalog in Silo's admin pages, adds settings sync, admin defaults, messages from your admin, themes, and MDBList and TMDB ratings. Live TV, music, playlists, SyncPlay, the admin panel, retro games, books and audiobooks aren't available on Silo.
  • Achievement Badges need the Achievement Badges plugin on a Jellyfin server. Once it's there, they show up under Settings > Integrations > Achievement Badges, and if the admin turns friends on in the plugin, so do Friends and chat.

What next

  • The User Guide covers the player controls, Live TV, casting, requests, and making the app look the way you want.
  • Downloads explains offline viewing.
  • If something doesn't work, Common Problems has the usual fixes.

Clone this wiki locally