Switchfin: Difference between revisions

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

← Older edit

Latest revision as of 04:36, 17 May 2026

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.9.0 2026/05/07

Add offline download manager by @docmeth02 in #209
Download manager improvements by @docmeth02 in #210
fix: zh-Hant translations by @dic1911 in #211

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