Tsukimi终极指南：3种简单方法快速安装这款Linux专属Jellyfin媒体播放器

Tsukimi终极指南：3种简单方法快速安装这款Linux专属Jellyfin媒体播放器

【免费下载链接】tsukimiA simple third-party Jellyfin client for Linux项目地址: https://gitcode.com/gh_mirrors/ts/tsukimi

你是否正在寻找一款专为Linux设计的Jellyfin客户端？Tsukimi可能就是你的理想选择！这款基于GTK4-RS开发的第三方Jellyfin客户端，不仅界面美观，而且功能强大，完美支持MPV视频播放器和GStreamer音频播放器，为你带来流畅的媒体播放体验。

作为一款完全免费的跨平台媒体播放器，Tsukimi不仅兼容Jellyfin服务器，还能部分支持Emby平台。无论你是电影爱好者、音乐发烧友，还是电视剧迷，这款开源应用都能满足你的所有需求。现在就让我们一起探索如何轻松安装和使用这款优秀的Jellyfin客户端吧！

为什么选择Tsukimi？5大独特优势

在开始安装之前，让我们先了解Tsukimi为何值得你尝试：

1. 原生Linux体验：专为Linux系统优化，完美集成GNOME桌面环境
2. 高性能播放引擎：基于MPV的视频播放和GStreamer的音频播放
3. 现代界面设计：采用GTK4和libadwaita框架，界面简洁优雅
4. 完整功能支持：支持Jellyfin所有基础功能和大部分管理功能
5. 开源免费：遵循GPLv3协议，完全免费且开源

Tsukimi的视频播放界面，支持弹幕评论和多集连播列表

3种安装方法对比：哪种最适合你？

选择正确的安装方法能让你事半功倍。下面是三种主要安装方式的详细对比：

方法一：Flatpak一键安装（推荐给新手）

对于大多数Linux用户来说，Flatpak是最简单快捷的安装方式。它就像手机应用商店一样，点击几下就能完成安装！

安装步骤详解

第一步：确保Flatpak已安装

# 在Debian/Ubuntu系统上 sudo apt update sudo apt install flatpak -y # 在Fedora系统上 sudo dnf install flatpak -y # 在Arch Linux上 sudo pacman -S flatpak

第二步：添加Flathub仓库

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

重要提示：Flathub是最大的Flatpak应用仓库，添加后你可以安装数千款应用！

第三步：安装Tsukimi

flatpak install flathub moe.tsuna.tsukimi -y

第四步：启动应用

flatpak run moe.tsuna.tsukimi

安装完成后，你可以在应用菜单中找到Tsukimi图标，点击即可启动！

方法二：使用系统包管理器安装

如果你更喜欢使用系统的包管理器，Tsukimi也提供了多种发行版的官方包支持。

Fedora用户

# 启用COPR仓库 sudo dnf copr enable walker874/tsukimi # 安装Tsukimi sudo dnf install tsukimi

技术细节：Fedora的COPR仓库配置可以参考官方文档：docs/COPR.md，这里详细说明了如何为Fedora构建RPM包。

Arch Linux用户

# 从AUR安装稳定版本 paru -S tsukimi-bin # 或者安装开发版本（最新功能） paru -S tsukimi-git # 或者使用archlinuxcn仓库 sudo pacman -Syu tsukimi-git

其他发行版

• AOSC OS：sudo oma install tsukimi
• Gentoo Linux：从gentoo-zh仓库安装
• Nix：从nixpkgs 24.11版本开始提供

方法三：从源码编译安装（适合开发者）

如果你想体验最新功能或进行二次开发，从源码编译是最好的选择。

准备工作

首先确保你的系统已安装必要的开发工具：

# 安装Rust工具链 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # 安装构建依赖 sudo apt install build-essential libgtk-4-dev libadwaita-1-dev libmpv-dev

编译安装步骤

# 克隆源代码 git clone https://gitcode.com/gh_mirrors/ts/tsukimi cd tsukimi # 编译发布版本 cargo build --release # 安装到系统 sudo install -Dm755 target/release/tsukimi /usr/local/bin/tsukimi

编译过程可能需要一些时间，具体取决于你的系统性能。完成后，你就可以在终端输入tsukimi来启动应用了！

首次配置：5分钟快速上手

安装完成后，让我们快速配置Tsukimi，开始你的媒体播放之旅！

连接Jellyfin服务器

1. 启动Tsukimi应用
2. 点击"添加服务器"按钮
3. 输入你的Jellyfin服务器信息：
   • 服务器地址：通常是你的本地IP或域名
   • 端口：默认8096
   • 用户名和密码：你的Jellyfin账号

个性化设置

进入设置界面，你可以调整：

• 界面主题：选择深色或浅色模式
• 播放设置：配置默认画质和字幕选项
• 网络设置：优化缓存和连接参数

Tsukimi的高级筛选功能，支持按格式、编码、分辨率等多种条件精确查找

核心功能深度体验

智能媒体库管理

Tsukimi的媒体库管理功能非常强大：

• 多视图模式：网格视图、列表视图自由切换
• 智能筛选：按类型、年份、分辨率、编码格式筛选
• 快速搜索：支持关键字搜索和高级搜索选项
• 播放列表：创建和管理个性化播放列表

专业级视频播放

基于MPV播放器，Tsukimi提供了专业级的视频播放体验：

• 格式全面支持：H.264、HEVC、VP9、AV1等主流编码
• 硬件加速：支持VAAPI、VDPAU、NVENC硬件解码
• 字幕管理：SRT、ASS、VTT等多种字幕格式
• 音轨切换：实时切换多音轨

高品质音乐播放

GStreamer驱动的音频播放系统：

• 专辑视图：按专辑分类展示音乐库
• 播放队列：创建和管理播放队列
• 音频效果：支持均衡器和音频增强
• 元数据支持：完整显示专辑封面和歌曲信息

Tsukimi的音乐播放界面，支持专辑封面显示和播放控制

实用技巧与优化建议

性能优化设置

为了让Tsukimi运行更流畅，可以尝试以下优化：

# 在MPV配置文件中添加硬件加速 hwdec=auto cache=yes cache-secs=30

常用快捷键

掌握这些快捷键能大幅提升操作效率：

网络优化

如果遇到播放卡顿，可以尝试：

1. 调整缓存大小：增加网络缓存
2. 启用硬件加速：减轻CPU负担
3. 降低画质：在网络不佳时选择较低分辨率

常见问题解决指南

Q1：无法连接到Jellyfin服务器怎么办？

解决方案：

1. 确认Jellyfin服务器正在运行
2. 检查服务器地址和端口是否正确
3. 验证防火墙设置，确保端口开放
4. 确认用户名和密码输入正确

Q2：视频播放卡顿或无法播放？

排查步骤：

1. 检查网络连接质量
2. 尝试降低视频质量设置
3. 启用硬件加速（如果显卡支持）
4. 更新显卡驱动程序

Q3：如何添加外部字幕？

操作步骤：

1. 确保字幕文件与视频文件同名
2. 在播放界面点击字幕按钮
3. 选择"添加字幕文件"
4. 浏览并选择字幕文件

Q4：如何更新Tsukimi？

更新方法：

• Flatpak用户：flatpak update moe.tsuna.tsukimi
• 系统包管理器：使用系统的更新命令
• 源码编译用户：重新拉取最新代码并编译

进阶功能探索

多服务器管理

Tsukimi支持同时连接多个Jellyfin服务器，你可以在左侧导航栏轻松切换不同的服务器，管理多个媒体库。

高级筛选功能

通过强大的筛选系统，你可以：

• 按视频编码格式筛选（H.264、HEVC等）
• 按音频编码格式筛选（AAC、FLAC等）
• 按分辨率筛选（720p、1080p、4K等）
• 按HDR类型筛选（SDR、HDR10、HLG等）

自定义界面

Tsukimi的源码结构清晰，如果你想进行二次开发或自定义界面，可以参考源码目录：src/，这里包含了所有的客户端代码和UI组件。

Tsukimi的媒体库管理界面，支持批量操作和分类浏览

社区与支持

获取帮助

如果你在使用过程中遇到问题，可以通过以下方式获取帮助：

1. 查看官方文档：项目文档提供了详细的使用说明
2. 参与社区讨论：加入Telegram群组与其他用户交流
3. 查看贡献指南：CONTRIBUTING.md了解如何参与开发

贡献代码

Tsukimi是一个开源项目，欢迎开发者贡献代码：

• 修复bug
• 添加新功能
• 改进文档
• 翻译界面

总结：开启你的Tsukimi之旅

通过本文的详细指南，你已经掌握了Tsukimi的三种安装方法和完整使用技巧。无论你是Linux新手还是资深用户，都能找到适合自己的安装方式。

选择建议

• 新手用户：推荐使用Flatpak安装，简单快捷
• 普通用户：使用系统包管理器安装，集成度好
• 开发者/高级用户：从源码编译，体验最新功能

开始使用

现在就开始你的Tsukimi体验吧！安装完成后，连接你的Jellyfin服务器，享受流畅的媒体播放体验。如果你有任何问题或建议，欢迎参与社区讨论，共同完善这款优秀的开源项目。

记住，Tsukimi不仅是一个媒体播放器，更是你个人媒体中心的完美伴侣。它的开源特性意味着你可以根据自己的需求进行定制，打造专属的媒体播放体验。祝你使用愉快！

Tsukimi的主界面，展示视频播放、推荐内容和继续观看功能

【免费下载链接】tsukimiA simple third-party Jellyfin client for Linux项目地址: https://gitcode.com/gh_mirrors/ts/tsukimi