Video Hub App 全功能媒体管理工具使用指南

一、解析核心价值

1.1 定位专业媒体中心

Video Hub App 是一款开源媒体管理解决方案，专注于本地视频资源的高效组织与播放。该工具采用Electron框架构建，整合Angular前端架构，实现跨平台运行能力，支持Windows、macOS及Linux系统环境。

1.2 核心优势

• 隐私优先架构：本地数据处理模式确保媒体文件不会上传至云端，所有元数据存储于用户设备
• 多格式编解码：原生支持MP4、MOV、MKV等主流视频格式，集成FFmpeg编解码组件
• 智能资源管理：通过标签系统、分辨率筛选和相似内容识别，实现海量视频库的快速检索

二、构建本地环境

2.1 准备开发环境

注意事项：需确保系统已安装Git 2.20+和Node.js 14.x以上版本

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/vi/Video-Hub-App
# 进入项目目录
cd Video-Hub-App

2.2 部署应用实例

# 安装项目依赖
npm ci --only=production
# 启动开发服务
npm run dev

三、场景应用指南

3.1 建立媒体库

1. 通过主界面"添加文件夹"功能导入视频目录
2. 系统自动生成缩略图与元数据索引
3. 使用标签管理功能对内容进行分类标记

3.2 高级检索技巧

• 利用多条件筛选：分辨率+时长+标签组合查询
• 启用模糊搜索功能匹配相似文件名
• 通过星级评分系统快速定位优质内容

四、生态拓展方向

4.1 家庭媒体服务器

通过配置node/server.ts模块，可将应用转换为本地媒体服务器，支持局域网内多设备访问。修改端口配置后，其他设备可通过浏览器访问媒体库。

4.2 自动化工作流集成

结合src/app/pipes/中的处理管道，可实现：

• 基于文件内容的自动标签生成
• 视频相似度分析与去重
• 自定义元数据提取规则

五、常见问题速查

Q: 启动后界面无响应如何处理？
A: 检查Node.js版本是否符合要求，删除node_modules目录后重新执行npm ci安装依赖。

Q: 视频缩略图生成失败怎么解决？
A: 确认FFmpeg已正确安装并添加至系统PATH，或在设置中指定FFmpeg可执行文件路径。

Q: 如何迁移媒体库到新设备？
A: 复制i18n/目录下的配置文件及src/assets/中的缩略图缓存，保持原视频文件路径结构即可实现无缝迁移。