User Guide

User Guide

Keyboard shortcuts, subtitle downloads, and remote device control. For tuning playback with your own mpv.conf, see Custom mpv Configuration.

Keyboard Shortcuts (Desktop)

App-wide

• Escape: Navigate back to the previous screen, or return to home if no history remains
• Enter/Return: Activate the currently focused item
• F11: Toggle fullscreen mode
• Ctrl+Q: Quit the application

Player

• Space: Play or pause playback
• Left Arrow: Seek backward (default 10 seconds)
• Right Arrow: Seek forward (default 30 seconds)
• Up Arrow: Increase volume
• Down Arrow: Decrease volume
• I: Display stream information overlay (codec, bitrate, resolution, etc.)
• Escape: Exit fullscreen (if in fullscreen), otherwise exit playback
• Enter/Space: Show player controls if hidden, or play/pause if controls are visible

Player (vim style)

The letter keys sit alongside the shortcuts above rather than replacing them, so either set works.

• K: Play or pause playback
• J: Seek backward, using the same skip length as the Left Arrow
• L: Seek forward, using the same skip length as the Right Arrow
• H: Exit playback
• F: Toggle fullscreen
• C: Turn subtitles off, or put the last track back on. With nothing to put back, the subtitle picker opens
• M: Mute or unmute
• , and .: Step the playback speed down or up

TV On-Screen Keyboard

The keyboard that opens for text fields on TV has a few tools beyond the letter grid:

• Caret keys (‹ and ›): move the cursor through the text, so a typo in the middle of a name or URL can be fixed in place instead of deleting back to it. Holding OK keeps the caret walking.
• Backspace: holding OK on the key 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 in the corner hold more characters. Keep OK held on the key (or long press on touch) to open them, then pick with the direction keys.
• Suggestion chips above the keys offer recent searches on the search screen, previously used usernames at sign in, and known server addresses when adding a server. Passwords never show suggestions.
• Number pad: numeric fields such as PINs and ports get a large phone-style pad.
• Layouts: the letter rows 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.

Subtitle Downloads

Download subtitles directly from the item details screen.

1. Open any Movie or Episode details screen.
2. In the details area, locate the Subtitles section.
3. Tap or click the download icon next to available subtitles.
4. Subtitles are saved in your downloads folder organized by media type and library structure.
5. Downloaded subtitles are automatically available for offline playback.

Synchronized subtitle timing is preserved during download. Use your preferred subtitle format (SRT, ASS, VTT, etc.) from your server's available sources.

Remote Device Control

Control other Jellyfin devices on your network directly from Moonfin.

How to use

1. Tap or click the user avatar in the top toolbar.

2. A dialog menu will appear with account and device options.

3. Select Remote Control from the menu.

4. A list of available Jellyfin devices on your server will appear, showing:

   • Device name
   • Current playback status (if applicable)
   • Device type icon

5. Select a device to send playback commands:

   • Play on Device: Start playback on the remote device
   • Pause: Pause playback on the remote device
   • Stop: Stop playback on the remote device
   • Volume Control: Adjust device volume if supported
   • Seek: Control playback position

Supported device types

• Desktop clients
• Mobile apps
• Web players
• Smart TV apps
• Media players (via Jellyfin server compatibility)

Requirements

• Device must be registered with your Jellyfin server
• Device must be actively online and connected to the network
• You must have playback permission for the content
• Both devices must be connected to the same Jellyfin server instance