如何在Windows、Mac和Linux上安装Jellyfin Media Player?新手教程
Jellyfin Media Player是一款基于Plex Media Player开发的桌面客户端,支持Windows、Mac OS和Linux系统,能够在同一窗口内通过jellyfin-web界面播放媒体内容,并支持音频直通功能。本文将为新手用户提供详细的跨平台安装指南,帮助你快速上手这款强大的媒体播放工具。
Jellyfin Media Player启动界面 - 简洁现代的设计让媒体播放体验更沉浸
下载官方预编译版本(推荐新手)
Jellyfin Media Player为各平台提供了便捷的预编译安装包,无需复杂配置即可快速使用:
- Windows & Mac用户:访问项目发布页面获取最新安装程序
- Linux用户:可通过Flathub安装:
flatpak install flathub com.github.iwalton3.jellyfin-media-player
预编译版本适合大多数普通用户,无需手动编译,点击下一步即可完成安装 🚀
Linux系统手动编译安装步骤
如果你需要最新特性或自定义编译选项,可以按照以下步骤在Linux系统手动构建:
1. 安装依赖项
sudo apt install autoconf automake libtool libharfbuzz-dev libfreetype6-dev libfontconfig1-dev libx11-dev libxrandr-dev libvdpau-dev libva-dev mesa-common-dev libegl1-mesa-dev yasm libasound2-dev libpulse-dev libuchardet-dev zlib1g-dev libfribidi-dev git libgnutls28-dev libgl1-mesa-dev libsdl2-dev cmake wget python g++ qtwebengine5-dev qtquickcontrols2-5-dev libqt5x11extras5-dev libcec-dev qml-module-qtquick-controls qml-module-qtwebengine qml-module-qtwebchannel qtbase5-private-dev
2. 编译并安装MPV
mkdir jmp; cd jmp
git clone https://gitcode.com/gh_mirrors/jel/jellyfin-media-player
cd jellyfin-media-player
./download_webclient.sh
cd build
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local/ ..
make -j4
sudo make install
Windows系统编译安装指南
Windows用户需要准备以下工具:
- cmake - 3.20.0以上版本
- ninja - 构建工具
- QT 5.15.2 - 勾选"MSVC 2019 64-bit"和"Qt WebEngine"
- VS2019 Build Tools
- libmpv1 - 媒体播放库
编译步骤:
git clone https://gitcode.com/gh_mirrors/jel/jellyfin-media-player
cd jellyfin-media-player
./download_webclient.sh
cd build
在"x86_x64 Cross Tools Command Prompt for VS 2019"中执行:
set PATH=%PATH%;C:\Program Files (x86)\WiX Toolset v3.11\bin
cmake -GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=output -DCMAKE_MAKE_PROGRAM=ninja.exe -DQTROOT=C:/Qt/5.15.2/msvc2019_64 -DMPV_INCLUDE_DIR=mpv/include -DMPV_LIBRARY=mpv/mpv.dll -DCMAKE_INSTALL_PREFIX=output ..
lib /def:mpv\mpv.def /out:mpv\mpv.dll.lib /MACHINE:X64
ninja
ninja windows_package
MacOS系统编译安装方法
1. 准备工作
安装必要依赖:
brew install mpv ninja
安装QT 5.15.2并确保勾选"Qt WebEngine"组件。
2. 编译安装
./download_webclient.sh
cd build
cmake -GNinja -DQTROOT=<QT_DIR> -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=output ..
ninja install
3. 修复库路径
为创建可分发的应用程序,需要修复库路径:
python3 ./scripts/fix-install-names.py ./build/output/Jellyfin\ Media\ Player.app
验证安装
安装完成后,你可以在应用程序菜单中找到Jellyfin Media Player。首次启动时,程序会引导你连接到Jellyfin服务器。如果遇到问题,可以查看日志文件:
- Windows:
%LOCALAPPDATA%\JellyfinMediaPlayer\logs - Linux:
~/.local/share/jellyfinmediaplayer/logs/ - macOS:
~/Library/Logs/Jellyfin Media Player/
配置文件位于:
- Windows:
%LOCALAPPDATA%\JellyfinMediaPlayer\ - Linux:
~/.local/share/jellyfinmediaplayer/ - macOS:
~/Library/Application Support/Jellyfin Media Player/
通过以上步骤,你已成功在Windows、Mac或Linux系统上安装了Jellyfin Media Player。现在你可以享受流畅的媒体播放体验,通过直观的界面管理和观看你的媒体库了! 🎬
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



