Tsukimi播放器v0.19.1完整使用指南：开源媒体播放器配置与优化

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

Tsukimi是一款简单高效的第三方Emby客户端，专为媒体爱好者设计。本文将带您全面了解这款开源播放器的安装方法、功能配置和使用技巧，助您打造个性化的媒体观影体验。

一、快速安装Tsukimi播放器

1.1 源码编译安装

如果您熟悉Linux系统，可以通过源码编译安装最新版本：

git clone https://gitcode.com/gh_mirrors/ts/tsukimi
cd tsukimi
cargo build --release

编译完成后，可在target/release目录下找到可执行文件。

1.2 Flatpak安装（推荐）

项目提供了Flatpak打包配置，您可以通过以下命令构建并安装Flatpak包：

flatpak-builder build-dir flatpak/moe.tsuna.tsukimi.yml --install --user

二、界面介绍与基础操作

Tsukimi采用现代化的用户界面设计，主要分为左侧导航栏、主内容区和播放控制区三部分。

Tsukimi播放器主界面，显示媒体库内容和播放控制区域

2.1 主要功能区域

• 左侧导航栏：包含首页、收藏、搜索和服务器管理功能
• 主内容区：展示媒体库内容，支持网格视图和列表视图切换
• 播放控制区：位于底部，提供播放/暂停、进度调节和音量控制

2.2 基本播放操作

播放媒体文件非常简单，只需双击媒体封面即可开始播放。播放过程中，您可以：

• 点击屏幕中央暂停/继续播放
• 使用鼠标滚轮调节音量
• 右键点击视频区域打开上下文菜单
• 通过右下角的控制栏调整播放速度和画质

Tsukimi播放控制界面，显示播放进度和字幕控制选项

三、高级功能配置

3.1 媒体库筛选与搜索

Tsukimi提供强大的媒体筛选功能，您可以通过多种条件快速找到想要观看的内容：

Tsukimi的筛选面板，支持按类型、年份、分辨率等多条件筛选

筛选条件包括：

• 播放状态（已观看/未观看）
• 媒体类型（电影/电视剧/音乐）
• 分辨率和编码格式
• 制作年份和评分

3.2 媒体库管理

Tsukimi支持多服务器管理，您可以在服务器菜单中添加多个Emby服务器。添加完成后，可以：

• 在不同服务器间快速切换
• 为每个服务器设置独立的登录凭据
• 自定义服务器显示名称和排序

媒体库视图支持多种布局方式，您可以通过右上角的视图切换按钮选择：

Tsukimi媒体库网格视图，展示大量媒体内容

四、音乐播放功能

除了视频播放，Tsukimi还提供完整的音乐播放功能，支持专辑视图和播放列表管理：

Tsukimi音乐播放界面，显示专辑信息和播放列表

音乐播放特色功能：

• 专辑封面显示和切换
• 歌曲收藏和评分
• 播放队列管理
• 后台播放支持

五、个性化设置

您可以通过设置菜单自定义Tsukimi的外观和行为：

• 外观设置：调整主题、颜色和字体大小
• 播放设置：配置默认播放质量和字幕偏好
• 网络设置：设置代理和缓存选项
• 快捷键设置：自定义常用操作的键盘快捷键

配置文件位于~/.config/tsukimi/目录下，您也可以直接编辑配置文件进行高级设置。

六、常见问题解决

6.1 无法连接到服务器

如果遇到服务器连接问题，请检查：

1. 服务器地址和端口是否正确
2. 网络连接是否正常
3. Emby服务器是否正在运行

6.2 播放卡顿或画质不佳

尝试以下解决方案：

1. 在播放设置中降低视频质量
2. 检查网络带宽是否充足
3. 清理本地缓存

七、总结

Tsukimi作为一款开源的Emby客户端，提供了丰富的媒体播放和管理功能，同时保持了简洁易用的用户界面。无论是视频还是音乐，都能为您带来出色的媒体体验。

如果您在使用过程中遇到问题，可以查阅项目文档或提交issue寻求帮助。项目源代码和更多信息可以在官方代码仓库找到。

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