hslr/xiaomi-camera-merge

小米摄像头视频文件合并工具

镜像概述

小米摄像头视频文件合并工具是一款针对小米摄像头视频文件管理的Docker镜像。由于小米摄像头上传至NAS的视频文件通常为一分钟一个片段，且NAS上的文件无法通过APP直接回看，导致使用不便。本工具基于Golang开发，支持跨平台运行，可将分散的一分钟视频片段按每小时合并为单个.mov格式文件，有效解决视频回看难题。

核心功能与特性

• 按小时合并：将分散的一分钟视频片段合并为每小时一个的完整视频文件
• 跨平台支持：基于Golang开发，支持通过Docker在多种系统环境运行
• 灵活配置：
  • 可选删除源文件功能，避免重复合并
  • 支持限制每次最大合并数量，适应大量视频文件场景
• 输出格式：合并后的视频文件为.mov格式，便于存储和播放

使用场景与适用范围

• NAS环境：专门解决小米摄像头上传至NAS的视频文件碎片化问题
• 家庭监控：方便用户回看完整的小时段监控视频
• 视频管理：减少视频文件数量，优化存储结构，提升管理效率

使用方法与配置说明

前提条件

• 已安装Docker环境
• 拥有小米摄像头视频文件存储目录（如NAS中的对应文件夹）

镜像拉取

bash
docker pull hslr/xiaomi-camera-merge:latest

基本运行命令

bash
docker run --rm -it -v /本地视频目录:/app/video hslr/xiaomi-camera-merge:latest

参数说明

目录挂载

• -v /本地视频目录:/app/video：将本地小米摄像头视频存储目录挂载到容器内的/app/video目录，需将/本地视频目录替换为实际存储路径（如NAS中的视频文件夹路径）

环境变量配置

• DELETE_SUCCESS（可选）：合并完成后是否删除源文件夹及视频文件
  • 取值：true（删除）或false（不删除，默认）
  • 作用：避免重复合并已处理的视频文件
• MAX_MERGE（可选）：每次最大合并数量限制
  • 取值：整数（默认值为0，表示不限制）
  • 作用：当视频文件数量巨大时，可分段执行合并任务

完整示例

删除源文件的合并命令：

bash
docker run --rm -it -v /mnt/xiaomi/camera:/app/video -e "DELETE_SUCCESS=true" hslr/xiaomi-camera-merge:latest

限制最大合并数量的命令（每次最多合并100个文件）：

bash
docker run --rm -it -v /mnt/xiaomi/camera:/app/video -e "MAX_MERGE=100" hslr/xiaomi-camera-merge:latest

同时配置删除源文件和限制合并数量：

bash
docker run --rm -it -v /mnt/xiaomi/camera:/app/video -e "DELETE_SUCCESS=true" -e "MAX_MERGE=50" hslr/xiaomi-camera-merge:latest

注意事项

• 确保挂载目录权限正确，容器需要对视频目录有读写权限
• 首次运行时建议先不启用DELETE_SUCCESS=true，验证合并效果后再开启删除功能
• 合并过程中请确保网络和存储设备稳定，避免中断导致文件损坏