Switchfin

Switchfin
General
Author	dragonflylee
Type	Media Players
Version	0.6.2
License	Apache-2.0
Last Updated	2025/02/28
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

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 Select

Plus - Show video profile

Screenshots

Changelog

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/