Vauldy Desktop v0.1.0

Vauldy Desktop v0.1.0 — Phase 1 MVP

Vauldy Desktop 的首个公开版本现已发布。

Vauldy Desktop 是 Vauldy 自托管媒体服务器的跨平台桌面客户端，基于 Tauri 2、React 19 和 mpv 构建，支持 Windows、Linux 与 macOS。

版本亮点

• 原生桌面体验，支持系统托盘及关闭时最小化
• 集成 mpv，实现高兼容性的本地媒体播放
• Windows 支持 mpv 嵌入式视频窗口
• 支持 HTML5 与 hls.js 播放回退
• 支持视频、音乐、照片及文档等多种媒体类型
• 支持简体中文、繁体中文、英语、日语和韩语
• 与 Vauldy Web UI 共享主要功能及服务端配置
• 支持从服务端同步应用名称、图标和界面语言

主要功能

服务器连接与账户

• 配置 Vauldy 服务器地址
• JWT 用户登录与会话持久化
• 自动处理登录失效并返回登录页面
• 同步用户语言及服务端品牌配置

媒体库

• 浏览电影、电视剧、动漫、音乐、照片和文档媒体库
• 首页展示媒体库、继续观看和最近添加内容
• 按标题、简介、类型及标签搜索媒体
• 查看媒体详情、演职人员、字幕及技术信息
• 管理收藏、收藏夹和播放列表
• 保存播放历史及观看进度

视频与音频播放

• 使用 mpv 播放视频和音频
• Windows 原生嵌入式视频画面
• 支持播放、暂停、跳转、音量调节和状态同步
• 根据编码、HDR、位深及字幕格式自动选择播放引擎
• 支持 HTML5 与 hls.js 播放回退
• 自动保存播放进度，支持继续观看
• 支持电视剧和播放列表连续播放
• 支持音乐专辑、艺术家、流派及歌词浏览

照片与文档

• 全屏照片浏览和原图下载
• 支持照片标签、地点及人物分类
• 支持 PDF、EPUB 及 Office 文档
• 保存并恢复文档阅读进度
• 支持编辑文档标题、作者、出版社、年份和标签

桌面集成

• 关闭主窗口时最小化至系统托盘
• 通过托盘菜单显示主窗口或退出应用
• 使用 Vauldy 品牌图标作为窗口及托盘图标
• 提供 Windows 构建脚本，可自动准备 mpv sidecar

支持的语言

• 简体中文（zh-CN）
• 繁体中文（zh-TW）
• English（en）
• 日本語（ja）
• 한국어（ko）

安装

在本 Release 的 Assets 区域下载适用于当前平台的安装包并完成安装。

首次启动后：

1. 输入 Vauldy 服务器地址，例如 http://127.0.0.1:8200
2. 使用 Vauldy 账户登录
3. 选择媒体库并开始播放

使用桌面客户端前，需要部署并运行兼容 API v1 的 Vauldy Media Server。

从源码构建

要求：

• Node.js 20+
• Rust stable
• mpv sidecar，或系统 PATH 中可用的 mpv

npm install
npm run tauri:build

Windows 也可以使用辅助构建脚本：

.\build.ps1

已知限制

• mpv 嵌入式视频窗口目前仅支持 Windows；Linux 和 macOS 使用独立 mpv 窗口
• 管理功能目前主要通过共享的 Web UI 提供
• 暂不支持从客户端上传本地媒体
• 暂不支持完整离线缓存及离线播放
• 暂不支持画中画或独立播放器窗口
• 暂无硬件解码配置界面，mpv 默认使用 --hwdec=auto
• 暂不支持开机自动启动配置
• 不同平台打包时需要提供对应的 mpv sidecar

技术栈

• Tauri 2 / Rust
• React 19 / TypeScript
• Ant Design 6
• Zustand
• i18next
• Axios
• hls.js
• mpv + JSON IPC
• Vite 6

感谢试用 Vauldy Desktop。欢迎通过 GitHub Issues 报告问题或提出建议。