Switchfin 一个用于任天堂 Switch 的 Jellyfin 客户端
Switchfin 是一款性能卓越的第三方 Jellyfin 原生客户端，全面覆盖游戏主机与桌面平台，为您带来极致家庭影音体验。
Switchfin 是面向 Jellyfin / Emby 媒体服务器的第三方原生客户端软件。它基于轻量级 C++17 引擎，充分利用各平台底层硬件加速能力，在 Nintendo Switch、PS4、PS Vita、Windows、macOS、Linux 及 Android 等设备上，为您呈现流畅的原生媒体浏览与播放体验。
项目采用 Nintendo Switch 风格界面设计（基于 Borealis UI 框架），交互逻辑针对游戏手柄深度优化，同时完美兼容键鼠与触摸操作。
二、核心功能
2.1 媒体库浏览
- 🔍 完整媒体库支持：电影、电视剧（含分季/分集）、音乐专辑、直播电视
- 📋 智能排序与筛选：按名称、日期、播放次数、社区评分等维度排序
- 🔎 全文搜索：实时搜索建议 + 跨媒体库检索
- 🎯 个性化推荐：最新添加、即将播出、相似推荐、"下一集"快捷入口
2.2 媒体播放
基于 libmpv 播放内核（底层 FFmpeg），提供专业级播放体验：
| 类别 | 支持格式 |
|---|---|
| 容器格式 | MKV, MOV, MP4, AVI |
| 视频编码 | H.264, H.265 (HEVC), VP8, VP9, AV1 |
| 音频编码 | Opus, FLAC, MP3, AAC, AC-3, E-AC-3, TrueHD, DTS, DTS-HD |
| 字幕格式 | SRT, VTT, SSA/ASS, DVDSUB |
播放器特性：
- ⚡ 智能播放策略：优先 Direct Play 直连播放，自动回退服务器转码
- 🎛️ 专业调控面板：多音轨/字幕轨切换、画面比例调节、视频滤镜、图像均衡器
- ⚙️ 硬件解码加速：各平台自动启用（VideoToolbox / VA-API / VDPAU / NVDEC / D3D11 / deko3d）
- 🏎️ 变速播放：支持 2x / 3x / 4x 倍速
- 📊 实时技术信息：编码、分辨率、码率、丢帧、硬件解码器状态一键查看
2.3 弹幕系统
集成 Jellyfin 弹幕插件：
- 🎨 滚动/顶部/底部/高级动画弹幕
- 🖋️ 四种字体效果（描边/斜边/阴影/纯色）
- 🔧 显示区域、透明度、字体大小、速度精细调节
- 🎭 按等级/类型/颜色智能过滤 + 蒙版防遮挡
2.4 远程文件浏览
无需 Jellyfin 服务器，直接连接远程文件服务：
| 协议 | 说明 |
|---|---|
| WebDAV | 支持认证的 WebDAV 服务器 |
| HTTP / HTTPS | Apache / Nginx / rClone HTTP 服务 |
| FTP / SFTP | 标准 FTP 与 SSH 文件传输 |
| 本地 | 直接读取设备本地文件 (file://) |
2.5 离线下载
- 📥 媒体内容下载至本地，离线观看
- 🎚️ 下载质量可选：原始画质 / 1080p / 720p / 480p
三、平台支持
Switchfin 是目前跨平台覆盖最广的 Jellyfin 第三方客户端之一：
| 平台 | 最低版本 | 渲染后端 | 安装方式 |
|---|---|---|---|
| 🎮 Nintendo Switch | 大气层/SX OS | deko3d | HB App Store / NRO |
| 🎮 PS4 | 9.00+ | GNM (PS4 GPU) | PKG Zone |
| 🎮 PS Vita | 3.60+ | GXM | VitaDB |
| 🪟 Windows | Windows 7+ | DirectX 11 | GitHub |
| 🍎 macOS | 10.15+ (Intel/Apple Silicon) | OpenGL / Vulkan | GitHub |
| 🐧 Linux | OpenGL 3.0+ | OpenGL / Vulkan | Flathub / |
| 📱 Android | — | OpenGL ES / MediaCodec | GitHub |
四、播放器操控
手柄操控
| 按键 (Xbox/通用) | 键盘 | 功能 |
|---|---|---|
| A | 空格 | 播放 / 暂停 |
| B | Esc | 停止播放 |
| Y | O | 切换 OSD 显示 |
| X | F4 | 打开设置菜单 |
| LB / RB | [ / ] | 快退 / 快进 |
| 左摇杆按下 | F1 | 视频技术信息 |
| 右摇杆按下 | F2 | 切换画质 |
| LT + 十字上下 | 数字键 | 音量调节 |
触摸手势
| 手势 | 功能 |
|---|---|
| 单击 | 显示/隐藏 OSD |
| 双击 | 播放/暂停 |
| 长按 | 临时加速播放 |
| 水平滑动 | 快进/快退 |
| 左侧竖直滑动 | 亮度调节 |
| 右侧竖直滑动 | 音量调节 |
五、系统要求
| 平台 | 要求 |
|---|---|
| Windows | Windows 7 或更高，DirectX 11.1 |
| macOS | 10.15+，Intel 或 Apple Silicon |
| Linux | OpenGL 3.0+，x86_64 或 ARM64 |
| Switch | 大气层/SX OS 自制系统 |
| PS4 | 固件 9.00+ |
| PS Vita | 固件 3.60+，已安装 HENkaku/enso |
- 网络建议：千兆局域网或 5GHz Wi-Fi（4K 串流推荐）
- 服务器：Jellyfin 10.8+ / Emby 4.7+
- 字幕字体：将 TTF 字体放至
{数据目录}/subfont.ttf
相关链接