如何自定义Linux Jellyfin的界面

Linux 上自定义 Jellyfin 界面的实用方案

一 基础外观与主题

• 登录管理后台：进入 Dashboard → Settings → Look and Feel，在 Theme 下拉中选择喜欢的主题，保存即可生效。
• 使用自定义 CSS：在 Custom CSS 文本框粘贴样式规则，适合做颜色、字体、间距等轻量美化。
• 快速示例（将顶部导航背景改为深蓝）：

  :root { --header-bg: #0b3d91 !important; }
  .header { background-color: var(--header-bg) !important; }
  

• 提示：CSS 只影响网页端；不同版本的可定制项可能略有差异。

二 使用 Skin Manager 插件一键换肤

• 安装插件：进入 Dashboard → 插件 → 仓库 → 添加仓库，输入地址：
  https://raw.githubusercontent.com/danieladov/JellyfinPluginManifest/master/manifest.json
  在插件目录搜索并安装 Skin Manager，安装后重启 Jellyfin。
• 更换主题：打开 Skin Manager，选择 Monochromic、Kaleidochromic 等主题，点击 Set Skin 并刷新页面。
• 手动导入：将第三方主题 .css 放入插件目录 plugins/SkinManager/custom，在插件中刷新列表后应用。
• 常见问题：
  • 安装后未生效：重启 Jellyfin，清浏览器缓存，再重新登录。
  • 使用 Nginx 反代显示异常：在反向代理的 Content-Security-Policy 中放行主题用到的字体/图片域名。

三 手动安装主题包与自定义 CSS/JS

• 准备主题包：下载主题 .zip（通常为前端资源）。
• 放置主题：将压缩包上传到 Jellyfin 可访问目录（常见为 /var/www/html/themes），如目录不存在先创建。
• 在后台启用：进入 Settings → Look and Feel → Themes → Add theme，选择上传的主题包并应用。
• 直接编辑前端资源（进阶）：
  • 安装目录通常为 /usr/share/jellyfin，Web 资源在 web/ 子目录。
  • 先备份原始文件，再按需修改 CSS/JS；修改后执行：

    sudo systemctl restart jellyfin
    

• 风险提示：直接改核心文件在升级时可能被覆盖，建议优先使用插件或自定义 CSS 覆盖机制。

四 桌面客户端 Jellyfin Media Player 的个性化

• 适用对象：使用 Jellyfin Media Player（基于 Qt/MPV 的桌面客户端）的用户。
• 外观与播放器参数：在客户端设置中切换 浅色/深色模式、调整 字体大小 等；播放参数可在设置或 mpv.conf 中自定义，例如：

  profile=gpu-hq
  scale=ewa_lanczossharp
  cscale=ewa_lanczossharp
  dscale=mitchell
  

• 快捷键与输入映射：编辑用户配置目录（Linux：~/.config/jellyfin-media-player/）下的 inputmaps.json 以重定义快捷键。
• 硬件加速：在设置或配置文件中启用 VA-API（Linux/Intel/AMD）等加速方式以提升播放性能。

五 维护与排错要点

• 备份与升级：自定义前备份 数据库 与 配置；直接修改前端文件可能在升级时被覆盖，尽量使用插件或自定义 CSS。
• 权限与路径：确保 Jellyfin 服务用户对主题目录（如 /var/www/html/themes）具备读取权限。
• 缓存与生效：更换主题或 CSS 后重启 Jellyfin 并清浏览器缓存；反代环境下检查 CSP 与静态资源路径。
• 版本兼容：主题需与当前 Jellyfin 版本匹配，异常多与 API/资源路径变更有关。