Switchfin

Switchfin
General
Author	dragonflylee
Type	Media Players
Version	0.8.3
License	Apache-2.0
Last Updated	2026/02/02
Links
Stable - Nightly Download
Website
Source

Switchfin is third-party PC player for Jellyfin that provides a native user interface to browse and play movies and series.

This project is in its early stages so expect bugs.

Features

• Completely native interface.
• Supported media items: movies, series, seasons, episodes.
  • Direct play and transcoding.
• Remote browser for Webdav/Apache/Nginx server.
• Base on MPV Player.
  • Container formats: mkv, mov, mp4, avi.
  • Video codecs: H.264, H.265, VP8, VP9, AV1.
  • Audio codecs: Opus, FLAC, MP3, AAC, AC-3, E-AC-3, TrueHD, DTS, DTS-HD.
  • Subtitle codecs: SRT, VTT, SSA/ASS, DVDSUB.
  • Optionally force software decoding when hardware decoding has issues.

User guide

If subtitles didn't display, try putting any ttf file at /switch/Switchfin/subfont.ttf.

To play media files on webdav server, edit config file config.json:

{
  "remotes": [
    {
      "name": "local",
      "url": "file:///switch"
    },
    {
      "name": "xiaoya",
      "passwd": "guest_Api789",
      "url": "webdav://192.168.1.5:5678/dav",
      "user": "guest"
    },
    {
      "name": "rclone",
      "url": "http://192.168.1.5:8000"
    }
  ]
}

example for using rClone setup HTTP server

rclone serve http --addr :8000 --read-only /media/downloads

To enable external drive on Switch, edit config file config.json

{
  "setting": {
    "ums": true
  }
}

Controls

During playback:

A - Play/Pause

B - Stop during

Y - Toggle OSD

X - Show Menu

R/L - Seek +/-

L - Stick Button Toggle Speed Select

R - Stick Button Toggle Video Quality

Plus - Show video profile

Screenshots

Changelog

v0.8.3 2026/02/02

• Fixed
  • add home tab retry dialog when request failed
  • deviceId/deviceName generate on linux
  • optimize font load on desktop platform
  • json parse failed when SeriesId is null
• Add
  • bonus video view for series tab

v0.8.2 2025/12/19

• Fixed
  • PS4: video freeze after fast fowarding (@crucifix86)
  • thumb image for episodes on home page
  • add refresh support for dashboard
• Add
  • option of ui scale
  • i18n: add spanish localization @Nyaran

v0.8.1 2025/12/09

• Fixed
  • stability improvement
  • adjust dashboard view
• Add
  • program tab for livetv

v0.8.0 2025/12/06

• Fixed
  • webdav client for clouddrive2.
  • refactor home tab for split media.
• Add
  • dashboard tab for view devices, activities etc.
  • video profile add subtitle codec.

v0.7.7 2025/11/17

• Fixed
  • switch: compatibility update for 21.0.0.
  • adjust direct play logic.
• Add
  • context menu for tag favorite.

v0.7.6 2025/10/22

• login issue on jellyfin 10.11
• switch: tls1.3 support by mbedtls
• ps4: av1 direct playback

v0.7.5 2025/09/17

• Add
  • Add song/artist tab for music.
  • Support receive media files as args.
  • i18n: add russian localization @wildrun0.
  • Add keyboard action binding config.

{
  "setting": {
    "key_last": "pgup",
    "key_next": "pgdn",
    "key_volume_up": "0",
    "key_volume_down": "9",
    "key_danmaku": "d",
    "key_video_profile": "f1",
    "key_video_quality": "f2",
    "key_video_speed": "f3",
    "key_setting": "f4",
    "key_refresh": "f5",
    "key_forward": "]",
    "key_rewind": "[",
    "key_video_osd": "o",
    "key_video_pause": "space"
  }
}

• Fixed
  • ps4: image load thread config.
  • Fix: distorted multichannel audio on PS4 by @mbars03 in #140.
• New Contributors
  • @mbars03 made their first contribution in #140.

v0.7.4 2025/07/15

• Fixed
  • LiveTV not working.

v0.7.2 2025/06/21

• Fixed
  • Audio/sub selection when transcode.
  • Vita: compress image texture.
  • Resume play on movie tab.
  • Linux/macos fixed zero-copy hwdec.

v0.7.1 2025/05/26

• Add
  • Add suggest/genres tab for collection.
• Fixed
  • Series/movie view logo layout.
  • Refactor media collection view.
  • Image load for search suggest.

v0.7.0 2025/05/16

• Add
  • Refactor series view layout.
  • Add people view of series/movie.
  • Add Brazilian Portuguese localization (@brunorossetto).
  • Switch: external drive support using libusbhsfs.
• Fixed
  • exception catch under macOS.
  • Remote load large file list.
  • Use mpv watch-later for remote.
  • subtitle not display on vita.

v0.6.2 2025/02/28

• Fixed
  • strm format support.
  • Search suggest include MusicAlbum
  • Improve image load speed.
  • Optimize auto quality option by @mutsumi63 in #90.
• Add
  • Add mirror play support.
  • Add korean localization (@KimPig).
  • Add psvita gxm support.
  • Custom vsync interval.

v0.6.0 2024/12/08

• Add
  • Add japanese localization (@yyoossk).
  • Add vietnamese localization (@tlover-code).
  • Support modify server url.
  • Remote add ftp/sftp support.
  • Remote add resume history.
• Fixed
  • Loading osd when change episode.
  • Update server info when check login.
  • Audio load failed when proxy enabled.
  • Navigate route of video view.
  • Focus logic of lock button.

v0.5.3 2024/10/27

• Add
  • Save windows state when exit.
  • Support touch input on linux (@xfangfang).
  • Support paste text to search input (@xfangfang).
  • New option low quality.
  • New option subtitle fallback.
  • Support custom user-agent in webdav browser.
  • apache/nginx/rclone http server support for remote.
• Fixed
  • Support loading custom emoji font.
  • Empty tab when search failed.

v0.5.2 Hotfix 2024/09/01

• Disable update notify when user canceled.
• Decode danmaku failed.
• Filter missing when sync option off.
• Auto selected external subtitles.

v0.5.1 2024/07/30

• Add
  • Upgrade ffmpeg 7.0.1.
  • Add highlight for current play track.
  • Add live tv support.
  • Add webdav file browser.
• Fixed
  • Network timeout for load video.
  • Panic after cancel login.
  • Abnormal focus when login after add server.
  • Server list url display.

v0.5.0 2024/05/22

• Added
  • danmu plugin integration.
  • Video flip and subtitle sync support for player.
  • Video equalizer setting.
  • Add episode selector on player view.
  • Add new option Always on top for desktop platform.
  • Czech localization.
• Fixed
  • Support MusicView and PlayList.
  • Forward nsp add startup logo.

v0.4.5 2024/04/12

• Added
  • Add chapter point on progress bar.
  • Touch gesture for volume/brightness.
• Fixed:
  • Collection display on new created user.
  • Scroll performance improvement @xfangfang.

v0.4.4 2023/01/28

• Added
  • Proxy option for http request.
  • Sync filter setting with official media player.
  • Setting entry from server add tab.
• Fixed
  • osd lock touch gesture.
  • Crash when open media filter of collection tab.
  • Wrong toggle icon after seek when paused.

v0.4.3 2023/01/19

• Added
  • Add logout from setting tab.
  • Player view add touch gesture.
  • Upgrade ffmpeg 6.1.1.
• Fixed:
  • Series tab: viewd badge.
  • Device name under macOS.

v0.4.2 2023/01/09

• Added
  • Add close button for series/collection.
  • Add lock button for player view.
  • Add close button for player view.
• Fixed
  • Auto hide osd on loading end.
  • Fix login disclaimer after switch server.
  • Fix cannot trigger loading next page after refresh.

v0.4.1 2023/11/26

• What's Changed
  • Add tap control for progress slider.
  • Add volume control for video.
  • Add play progress on more page.
  • Add login disclaimer display.
• Bug fixed
  • Server selection by joystick.
  • Fix home tab auto refresh.

v0.4.0 2023/11/16

• What's Changed
  • Add music album support.
  • Save video quality to config.
  • Add option of player_inmemory_cache.
  • Improve password input.
  • Update ffmpeg to 6.1.
  • Add experimental support for deko3d backend.
• Bug fixed
  • Option for speed control.
  • osd show timeout.

v0.3.4 2023/11/10

• What's Changed
  • Add option for open debug layer.
  • Add support of clear search history.
• Bug fixed
  • Improve url check for server add.
  • Fix osd navigate with dpad/analog stick.

v0.3.3 2023/11/08

• What's Changed
  • Movie collection support.
  • Add filter for media collection.
  • Add speed up feature when pressed on.
  • Add play/stop action when double click.
  • Upgrade ffmpeg to release/6.1.
  • ci: add d3d11 backend for win32.
• Bug fixed
  • Fix server list focus route.

v0.3.2 2023/09/27

• Add new option forceDirectPlay.
• Support chapter select.
• Support subtitle/audio track selection on transcode play.
• ci: add mingw64 workflow.
• Fix trancode codec type.
• Fix crash on exit when playing media.
• Switch: sub fallback font.

v0.3.1 2023/09/18

• Switch: FFmpeg: support vp9 hwdec.
• Server list support user selection.
• Login quick connect support.
• Crash when http exception.
• Flac audio direct play.

v0.3.0 2023/09/08

• Switch: FFmpeg: Update to 6.0 with hwaccel backend, Thanks to averne.
• Set mpv option subs-fallback to yes.
• Complete server list selector.
• Fix searies tab layout.
• curl enable ipv6 support.
• Search result not update when delete charactor.
• Fix: setting selection which required restart.

v0.2.0 2023/08/27

• Feat: Add german by @Sorunome.
• Change max password length to 256 by @Sorunome.
• Feats: add search tab by @dragonflylee.
• Feats: resume card add progress bar by @dragonflylee.
• Feats: media series add overview by @dragonflylee.
• Fix: nx self upgrade by @dragonflylee.

v0.1.1 2023/08/14

• Fix subtitle track selection (@dragonflylee).
• Fix unable to pause with JoyCon by @dic1911.
• Typo fix and add zh-Hant translation by @dic1911.
• Remove highlight border in video view by @dic1911.
• More options for playback by @dic1911.

Credits

Thanks to:

• @xfangfang for wiliwili.
• @devkitpro and switchbrew for libnx.
• @natinusala and XITRIX for borealis.
• @proconsule for nxmp.
• @averne for great work of FFmpeg hwaccel backend.

External links

• GitHub - https://github.com/dragonflylee/switchfin
• GBAtemp - https://gbatemp.net/threads/switchfin-jellyfin-client-for-nintendo-switch.639930/