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

Project repository|Stable Build|Nightly Build

This project is in its early stages so expect bugs.

Screenshots​

Home	Library
Search	Music
Series	Episode

Features​

• Completely native interface
• Supported media items: movies, series, seasons, episodes
  • Direct play and transcoding
• 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.

Input mapping 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
• + Show video profile

ChangeLog​

0.8.3 (2016-02-02)
fix json parse failed when SeriesId is null
add bonus video view for series tab
add add home tab retry dialog when request failed

0.8.2 (2025-12-20)
fix thumb image for episodes on home page
add refresh support for dashboard
add option of ui scale
add add spanish/french localization

0.8.1 (2025-12-09)
stability improvement
adjust dashboard view
add program tab for livetv

0.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

0.7.7 (2025-11-17)
compatibility update for 21.0.0
adjust direct play logic

0.7.6 (2025-10-22)
fix login issue on jellyfin 10.11
improve tls1.3 support by mbedtls

0.7.5 (2025-09-17)
add song/artist tab for music
support receive media files as args
i18n: add russian localization @wildrun0

0.7.4 (2025-07-25)
fix LiveTV not working

0.7.2 (2025-06-21)
fixed audio/sub selection when transcode
fixed resume play on movie tab

0.7.1 (2025-05-26)
add suggest/genres tab for collection
fix image load for search sugguest
fix series/movie view logo layout

0.7.0 (2025-05-16)
refactor series view layout
add people view of series/movie
add Brazilian Portuguese localization (@brunorossetto)
add external drive support
fix remote load large file list
use mpv watch-later for remote

0.6.3 (2025-03-12)
add player option for video rotate
add photo viewer support
upgrade ffmpeg 7.1.1
websocket close gracefully

0.6.2 (2025-02-27)
fix strm format support
search suggest include `MusicAlbum`
improve image load speed
optimize auto quality option
add mirror play support
add korean localization
add psvita gxm support

0.6.1 (2024-12-22)
ignore save resume on m3u playlist
ignore save window stat when fullscreen
fix websocket support on switch

0.6.0 (2024-12-7)
add japanese localization (@yyoossk)
add vietnamese localization (@tlover-code)
support modify server url
remote add ftp/sftp support
remote add resume history
fix loading osd when change episode
fix update server info when check login
fixaudio load failed when proxy enabled
fixnavigate route of video view
fix focus logic of lock button

0.5.3 (2024-10-27)
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
http server support for remote
support loading custom emoji font
fixed empty tab when search failed

0.5.1 (2024-7-30)
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
fixed panic after cancel login
fixed abnormal focus when login after add server
fixed server list url display

0.5.0 (2024-5-22)
add danmu plugin integration
add video flip and subtitle sync support for player
add video equalizer setting
add episode selector on player view
add new option `Always on top` for desktop platform
add Czech localization
support `MusicView` and `PlayList`
forward nsp add startup logo

0.4.4 (2023-1-28)
add proxy option for http request
sync filter setting with official media player
add setting entry from server add tab
fix osd lock touch gesture
fix wrong toggle icon after seek when paused
fix crash when open filter

0.4.3 (2023-1-19)
add logout from setting tab
player view add touch gesture
upgrade ffmpeg 6.1.1
fix series tab viewed badge
fix device name under macOS

0.4.2 (2023-1-09)
add close button for series/collection
add lock button for player view
auto hide osd on loading end
fix login disclaimer after switch server
fix cannot trigger loading next page after refresh

0.4.1 (2023-11-26)
add tap control for progress slider
add volume control for video
add play progress on more page
add login disclaimer display
fixed server selection by joystick
fix home tab auto refresh

0.4.0 (2023-11-16)
add music album support*
save video quality to config
add option of player_inmemory_cache
improve password input
fix option for speed control
fix osd show timeout

0.3.4 (2023-11-10)
add option for open debug layer
add support of clear search history
improve url check for server add
fix osd navigate with dpad/analog stick

0.3.3 (2023-11-8)
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

0.3.2 (2023-9-27)
add new option forceDirectPlay
support chapter select
support subtitle/audio track selection on transcode play
fix trancode codec type
fix crash on exit when playing media

0.3.1(2023-9-18)
switch: FFmpeg: support vp9 hwdec
server list support user selection
login quick connect support
fix crash when http exception

0.3.0 (2023-9-8)
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
fix search result not update when delete charactor
fix: setting selection which required restart

If external subtitle didn't display correctly, please put your font to /switch/Swichfin/subfont.ttf

Post here any kind of bug/suggestions.
Enjoy!

Thanks to​

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

 

[TheStonedModder]

This is the best thing ever! Great work

The more devices that support jellyfish the closer I can get to ditching plex for good

 

[Gaara4]

I got this error message "SSL connect error"
I just put in the server ip "https://192.168.178.xx:8096" like i do it in my browser
The server runs on an rapsberry pi 4

 

[dragonflylee]

I got this error message "SSL connect error"
I just put in the server ip "https://192.168.178.xx:8096" like i do it in my browser
The server runs on an rapsberry pi 4

maybe your server url is http://192.168.178.xx:8096
not https

 

[Gaara4]

Ok shame on me. Of course thats was the problem. Thanks

I also have the problem that on some videos i can not select the audi or subtitle. I know that the file does have multiple languages but i can not change it. I only appers on some shows. It might be the container but i dont know. It works on my firestick with the jellyfin app.

 

[dragonflylee]

Ok shame on me. Of course thats was the problem. Thanks

I also have the problem that on some videos i can not select the audi or subtitle. I know that the file does have multiple languages but i can not change it. I only appers on some shows. It might be the container but i dont know. It works on my firestick with the jellyfin app.

switchfin has some issue in transcode mode for now, such as audio/sub selection ,
you can confirm video profile by press `minus` button.

can you take screenshot of video profile?

 

[linuxares]

Holy cow! I remember talking about Jellyfin and it might be possible for Switch. Seems like you proved me to be right

Great job!

EDIT: ooh frontpaged :3

 

[proconsule54]

Very very good! Fresh air for the scene

 

[ostebob]

Might be off topic, but could the hw accel be used for moonlight?

Edit: github/XITRIX/Moonlight-Switch/pull/113

 

[Gaara4]

switchfin has some issue in transcode mode for now, such as audio/sub selection ,
you can confirm video profile by press `minus` button.

can you take screenshot of video profile?

Sure. Here a two examples.

 

[proconsule54]

OSD File Stats output if terrific! Nice job!

 

[wiiu20603]

I got this error message "SSL connect error"
I just put in the server ip "https://192.168.178.xx:8096" like i do it in my browser
The server runs on an rapsberry pi 4

You really don't need to hide local IP addresses.
If somebody's in your network, you're screwed. An attacker can find the local IP address of everything on the network.

My locally hosted server with every file and photo from the past 20 years is located at 192.168.1.134.

 

[octopus]

Sick homebrew, thank you.
Subtitles do not seem to work, using DirectPlay.

 

[linuxares]

Sick homebrew, thank you.
Subtitles do not seem to work, using DirectPlay.

Did you try the suggestion?

If external subtitle didn't display correctly, please put you font to /switch/Swichfin/subfont.ttf

 

[VashTS]

can Jellyfin connect to my existing plex server?

 

[linuxares]

can Jellyfin connect to my existing plex server?

Jellyfin isn't Plex.

Jellyfin is based on Emby.

 

[Psycho]

this is so fkin clean!! i like clean

great work!

 

[jomaper]

This is the best thing ever! Great work

The more devices that support jellyfish the closer I can get to ditching plex for good

what's wrong with plex?

 

[BaamAlex]

Nxmp is my favorite, but I will definitely test this too. Looks great. Thanks for this.

 

[TobiasAmaranth]

Nxmp is my favorite, but I will definitely test this too. Looks great. Thanks for this.

I tested Nxmp recently, it's definitely decent. My problem is that I'm a networking dunce so I don't know how to set myself up a local file hosting from my non-Linux PC, heh.