如何安装Jellium Desktop？跨平台完整指南（Linux/Windows/macOS）
【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellium-desktop
想要在桌面上享受Jellyfin媒体服务器的原生体验吗？Jellium Desktop是一个基于CEF和mpv构建的Jellyfin非官方桌面客户端，为您提供流畅的本地播放体验。本指南将详细介绍在Linux、Windows和macOS三大平台上的安装方法，无论您是新手还是高级用户，都能找到适合您的安装方式。
🎯 Jellium Desktop是什么？
Jellium Desktop是一个专为Jellyfin媒体服务器设计的桌面客户端应用。它结合了Chromium Embedded Framework（CEF）的现代Web渲染能力和mpv播放器的高质量视频解码技术，为您带来：
- 原生桌面体验- 独立的应用程序，无需浏览器
- 高性能播放- 利用mpv的硬件加速解码
- 跨平台支持- 支持Linux、Windows和macOS
- 无缝集成- 与Jellyfin服务器完美协作
📦 快速下载安装
Linux系统安装
AppImage方式（推荐）
AppImage是最简单的安装方式，适用于大多数Linux发行版：
从下载链接获取对应架构的AppImage文件：
- x86_64架构：下载链接
- aarch64架构：下载链接
下载完成后，赋予执行权限：
chmod +x Jellium-Desktop-*.AppImage双击运行或通过终端启动：
./Jellium-Desktop-*.AppImage
Arch Linux (AUR)
Arch用户可以通过AUR直接安装：
yay -S jellium-desktop-gitFlatpak安装
Flatpak提供了沙盒化的运行环境：
- 下载Flatpak bundle：下载链接
- 安装Flatpak bundle：
flatpak install --bundle Jellium-Desktop-*.flatpak
macOS系统安装
直接下载安装
根据您的Mac芯片类型选择对应版本：
- Apple Silicon (M1/M2/M3)：下载链接
- Intel处理器：下载链接
安装步骤
- 下载并解压ZIP文件
- 将"Jellium Desktop.app"拖到"应用程序"文件夹
- 重要：移除隔离属性（避免Gatekeeper阻止）：
sudo xattr -cr /Applications/Jellium\ Desktop.app - 在Launchpad或应用程序文件夹中启动应用
Windows系统安装
下载安装包
根据您的Windows版本选择：
- 64位系统 (x64)：下载链接
- ARM64系统：下载链接
安装步骤
- 下载对应版本的ZIP文件
- 解压到任意文件夹（建议C:\Program Files\Jellium Desktop）
- 运行"jellium-desktop.exe"即可启动
- （可选）创建桌面快捷方式
🛠️ 从源码编译安装
如果您是开发者或需要自定义功能，可以从源码编译安装Jellium Desktop。
准备工作
项目使用just作为命令行工具，请先安装：
# Linux/macOS cargo install just # Windows winget install Casey.Just克隆仓库
git clone https://gitcode.com/gh_mirrors/je/jellium-desktop cd jellium-desktop平台特定编译步骤
Linux编译
just deps # 安装依赖 just build # 编译应用 just run # 运行应用macOS编译
just deps # 安装依赖（包括Homebrew包） just build # 编译并打包到build/output just run # 运行应用Windows编译
just deps # 安装依赖（PowerShell脚本） just build # 编译应用 just run # 运行应用🔧 常用开发命令
项目提供了丰富的开发工具链：
| 命令 | 功能 | 说明 |
|---|---|---|
just build | 编译应用 | 生成可执行文件 |
just run | 运行应用 | 带调试日志输出 |
just run-mpv | 运行mpv CLI | 直接测试mpv播放器 |
just test | 运行测试 | 完整的测试套件 |
just fmt | 代码格式化 | 保持代码风格一致 |
just lint | 代码检查 | 格式化检查+clippy |
just clean | 清理构建 | 删除build/和dist/目录 |
🎬 首次使用指南
连接Jellyfin服务器
- 启动Jellium Desktop应用
- 输入您的Jellyfin服务器地址（如：http://192.168.1.100:8096）
- 输入用户名和密码登录
- 开始享受您的媒体库！
播放设置优化
- 硬件加速：默认启用，确保最佳播放性能
- 字幕支持：支持外挂字幕和内置字幕
- 音频输出：支持多声道音频和直通
- 播放控制：支持快捷键和远程控制
🚀 高级功能
多平台打包
项目支持多种打包格式：
- Linux：AppImage、Flatpak
- macOS：DMG磁盘映像
- Windows：可执行程序包
自定义构建
您可以通过修改src/目录下的源代码来自定义功能：
- 播放器核心：src/mpv/
- CEF集成：src/jfn_cef/
- 平台特定代码：src/linux/、src/macos/、src/windows/
- Web界面：src/web/
🔍 故障排除
常见问题
Linux：AppImage无法运行
# 检查文件权限 chmod +x Jellium-Desktop-*.AppImage # 检查依赖 ldd Jellium-Desktop-*.AppImagemacOS：应用被阻止
# 移除隔离属性 sudo xattr -cr /Applications/Jellium\ Desktop.app # 或在系统设置中允许运行Windows：缺少运行库
- 安装Visual C++ Redistributable
- 确保.NET Framework最新版本
日志查看
应用日志默认输出到build/run.log，可通过环境变量调整：
export JELLIUM_DESKTOP_LOG_LEVEL=debug export JELLIUM_DESKTOP_LOG_FILE=my_log.txt📈 性能优化技巧
- 启用硬件解码：确保显卡驱动已正确安装
- 调整缓存大小：根据网络情况调整播放缓存
- 使用有线网络：无线网络可能影响4K流媒体播放
- 定期更新：关注项目更新获取性能改进
🎉 开始使用Jellium Desktop
现在您已经掌握了Jellium Desktop的完整安装指南！无论您选择预编译包还是从源码编译，都能轻松在桌面端享受Jellyfin的丰富媒体内容。
记住定期检查更新，项目会不断改进性能和添加新功能。如果您遇到问题或有功能建议，欢迎参与社区讨论！
温馨提示：首次连接服务器时可能需要一些时间加载媒体库，请耐心等待。享受您的Jellyfin桌面体验吧！🎬
【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellium-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
