开源媒体播放器Tsukimi：打造个人媒体中心的终极指南

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

想要在Linux系统上享受流畅的Jellyfin媒体播放体验吗？开源媒体播放器Tsukimi正是您需要的解决方案。作为一款基于GTK4和Rust开发的第三方Jellyfin客户端，Tsukimi不仅支持视频播放，还能完美处理音乐和专辑，为您带来全方位的媒体娱乐体验。这款跨平台播放器采用现代化的界面设计，结合MPV视频播放器和GStreamer音频引擎，确保在各种媒体格式上都能提供出色的播放性能。

项目概览：为什么选择Tsukimi？

在众多媒体播放工具中，Tsukimi以其简洁的设计和强大的功能脱颖而出。作为一款开源媒体播放器，它完全免费且透明，您可以自由查看和修改源代码。Tsukimi的核心优势在于其对Jellyfin服务器的完美支持，同时保持对Emby的部分兼容性，这意味着您可以轻松连接到现有的媒体库系统。

Tsukimi播放器主界面展示，清晰的左侧导航栏和媒体内容展示区

这款播放器的跨平台特性使其能够在Linux、Windows等多个操作系统上运行，无论您使用哪种桌面环境，都能获得一致的体验。更重要的是，Tsukimi采用了模块化架构设计，这意味着未来功能的扩展和优化将变得更加容易。

快速入门：三分钟搭建您的媒体中心

安装方式选择：从简单到专业

对于大多数用户来说，最简单的方式是通过Flatpak安装。只需访问Flathub商店，搜索"Tsukimi"即可一键安装。如果您使用的是Arch Linux，可以通过AUR仓库快速获取：

paru -S tsukimi-bin

对于喜欢从源码构建的用户，Tsukimi提供了详细的编译指南。首先克隆仓库：

git clone https://gitcode.com/gh_mirrors/ts/tsukimi
cd tsukimi
git submodule update --init --recursive

然后按照官方文档：docs/build_on_linux.md 中的步骤进行编译。这种方法虽然稍显复杂，但能让您获得最新的功能和优化。

服务器连接配置

安装完成后，启动Tsukimi，您会看到一个简洁的界面。左侧导航栏是连接服务器的入口。点击"添加服务器"按钮，输入您的Jellyfin服务器地址和凭据。Tsukimi支持标准的HTTP/HTTPS连接，确保您的媒体库能够安全访问。

Tsukimi的资源库界面，支持卡片式浏览和多种分类筛选

💡 小技巧：如果连接遇到问题，请检查服务器地址格式是否正确（如http://192.168.1.100:8096），并确保网络连接正常。Tsukimi会自动保存您的服务器配置，下次启动时无需重新输入。

核心功能深度解析：不只是播放器

智能媒体管理与筛选系统

Tsukimi的真正强大之处在于其智能的媒体管理系统。面对庞大的媒体库，如何快速找到想看的内容？Tsukimi的多维度筛选功能为您提供了完美的解决方案。

Tsukimi的智能筛选面板，支持播放状态、类型、编码等多维度筛选

通过筛选面板（快捷键Ctrl+F），您可以按播放状态（已观看/未观看）、媒体类型、分辨率、编码格式（AV1/VP9/HEVC/H.264）等多个条件进行组合筛选。例如，您可以设置"未观看+动画+1080p+HEVC编码"来快速定位高质量的新动画资源。

专业的播放控制体验

Tsukimi基于MPV视频播放器，这意味着您可以享受到MPV的所有高级功能。双击任何媒体封面即可开始播放，右键菜单提供了丰富的控制选项：

• 播放速度调整（0.5x到2.0x）
• 音轨和字幕切换
• 视频缩放和旋转
• 截图和书签功能

Tsukimi的视频播放界面，包含播放列表、评论互动和进度控制

播放过程中，鼠标悬停在进度条上会显示预览缩略图，帮助您快速定位到特定场景。右上角的播放列表功能让您轻松管理剧集顺序，而底部的控制栏则提供了完整的播放控制。

全媒体支持：从视频到音乐

Tsukimi不仅是一个视频播放器，还是一个完整的音乐播放解决方案。切换到音乐模式，您可以享受专辑封面显示、曲目列表管理和智能播放列表功能。

Tsukimi的音乐播放界面，支持专辑封面显示和曲目管理

音乐播放支持后台运行，即使最小化程序，音乐仍会继续播放。您可以为喜欢的歌曲添加评分和收藏，创建个性化的播放列表。配置文件位于用户目录下的.config/tsukimi文件夹中，高级用户可以直接编辑配置文件实现更精细的控制。

个性化定制：打造专属播放体验

界面主题与布局调整

Tsukimi支持浅色、深色和系统主题三种模式，您可以根据环境光线和个人偏好进行切换。在设置菜单中，还可以调整：

• 视图布局：网格视图或列表视图
• 项目间距和大小
• 字体大小和样式
• 动画效果开关

快捷键自定义

虽然Tsukimi提供了丰富的默认快捷键，但您可以根据自己的使用习惯进行自定义。常用的快捷键包括：

• 空格键：播放/暂停
• 方向键左右：快进/快退
• 方向键上下：音量调节
• F键：全屏切换
• M键：静音切换

高级配置选项

对于高级用户，Tsukimi提供了详细的配置文件系统。您可以通过编辑配置文件来调整MPV的底层参数，实现更精细的视频和音频控制。相关的配置模块位于：src/config/ 目录中，这里包含了播放器的主要配置逻辑。

常见问题与实用技巧

播放问题解决指南

遇到播放卡顿或无声音时，可以尝试以下解决方案：

1. 检查网络连接：确保服务器连接稳定
2. 调整播放质量：在设置中降低分辨率或关闭硬件加速
3. 更新系统组件：确保显卡驱动和多媒体库为最新版本
4. 检查媒体格式：确认文件格式受MPV支持

服务器连接故障排除

如果无法连接到Jellyfin服务器：

1. 验证服务器地址：确保地址格式正确且端口开放
2. 检查防火墙设置：确保8096端口（默认Jellyfin端口）未被阻止
3. 服务器状态确认：确保Jellyfin服务正在运行
4. 凭据检查：确认用户名和密码正确

性能优化建议

• 启用硬件加速可以显著降低CPU使用率
• 定期清理缓存文件可以释放磁盘空间
• 调整缓冲大小可以改善网络流媒体播放体验
• 使用本地字体可以避免字幕渲染问题

进阶探索：参与开源社区

贡献代码与功能改进

Tsukimi作为开源项目，欢迎所有开发者参与贡献。如果您熟悉Rust编程语言，可以查看项目源代码，了解其架构设计。主要的UI组件位于src/ui/目录，而客户端逻辑则在src/client/中。

翻译与本地化支持

如果您希望帮助将Tsukimi翻译成更多语言，可以通过Weblate平台参与翻译工作。目前项目已经支持中文、日语、法语、德语等多种语言，但仍有改进空间。

反馈与问题报告

在使用过程中遇到任何问题或有功能建议，可以通过GitHub Issues页面提交反馈。开发团队会定期查看并回应社区的需求。

结语：开启您的开源媒体之旅

Tsukimi不仅仅是一个播放器，更是一个完整的媒体中心解决方案。它结合了开源软件的透明性和专业播放器的功能性，为用户提供了既简单又强大的媒体体验。无论您是Jellyfin的现有用户，还是正在寻找一款优秀的开源媒体播放器，Tsukimi都值得一试。

从简单的视频播放到复杂的媒体库管理，从基本的音乐播放到高级的个性化定制，Tsukimi都能满足您的需求。更重要的是，作为一个开源项目，它的未来由社区共同塑造。加入Tsukimi的用户和开发者社区，一起打造更好的开源媒体播放体验！

🚀 立即开始：访问项目仓库，获取最新版本，开始您的Tsukimi媒体之旅！

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