archive

Archive - 媒体文件智能归档与转码工具

Archive 是一个基于 Go 语言开发的专业级媒体文件整理与转码工具库，专注于帮助用户高效地将视频、音频和图像文件转换为更现代、更节省空间的编码格式。

🎯 核心功能

视频处理

• MKV 转 H.265: 智能转换 MKV 文件为 H.265/HEVC 格式，完整保留所有音轨和字幕轨道
• 通用视频转码: 支持任意视频格式转换为 H.265 编码的 MP4 文件，并添加 hvc1 兼容标签
• 快速标准化: 提供快速 H.264(AVC) 标准化转换，适用于流媒体播放
• 智能格式检测: 自动识别视频编码格式，避免重复转换

图像处理

• AVIF 转换: 将各种图像格式高效转换为现代 AVIF 格式，显著减少文件体积
• 智能跳过: 自动跳过 GIF 等特殊格式文件

音频处理

• 有声书优化: 支持有声书音频加速处理（65%速度）并提升音量
• 音乐处理: 针对不同类型音频提供定制化处理方案
• 格式标准化: 统一音频采样率、比特率等参数

数据管理

• SQLite 记录: 自动记录每次转换的文件信息和空间节省情况
• 历史追踪: 完整保存转换历史，便于统计和回溯

🚀 快速开始

系统要求

• Go 1.21 或更高版本
• FFmpeg (必需) - 视频/音频处理引擎
• MediaInfo (推荐) - 媒体信息分析
• libavif (推荐) - AVIF 图像编码

安装依赖

Windows

# 安装 FFmpeg
choco install ffmpeg

# 安装 MediaInfo
choco install mediainfo

# 安装 libavif
# 从 https://github.com/AOMediaCodec/libavif 下载预编译版本

macOS

brew install ffmpeg mediainfo libavif

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install ffmpeg mediainfo
# libavif 需要从源码编译或使用 snap 安装

安装 Archive

go get github.com/zhangyiming748/archive@latest

💡 使用示例

基础用法

package main

import (
    "log"
    "github.com/zhangyiming748/archive"
    "github.com/zhangyiming748/finder"
)

func main() {
    // 批量转换视频文件为 H.265
    videos := finder.FindAllVideos("/path/to/videos")
    for _, video := range videos {
        archive.Convert2H265(video)
    }
    
    // 转换单个图片为 AVIF
    archive.Convert2AVIF("/path/to/image.jpg")
    
    // 处理有声书音频
    archive.ConvertAudio("/path/to/audiobook.mp3", archive.AudioBookType)
}

高级功能

// MKV 文件专用处理（保留所有轨道）
archive.ConvertMKV2H265("/path/to/movie.mkv")

// 快速标准化转换
archive.FastConvertVideo2StandAvc("/path/to/video.avi")

// 字幕内嵌处理
err := archive.MergeMp4WithSameNameSrt("video.mp4", "subtitle.srt")
if err != nil {
    log.Fatal(err)
}

🔧 API 文档

视频处理函数

图像处理函数

音频处理函数

常量定义

const (
    AudioBookType = "audiobook"  // 有声书类型
    RapMusicType  = "rap"        // 说唱音乐类型
    Volume        = "2.7"        // 音频音量增益
)

📊 性能特点

• 智能检测: 自动跳过已优化的文件，避免重复处理
• 空间节省: H.265 编码相比 H.264 可节省 30-50% 存储空间
• 质量保持: 在大幅压缩的同时维持优秀的视觉质量
• 批量处理: 支持大规模文件批处理操作
• 进度追踪: 实时显示转换进度和空间节省情况

🛠️ 技术架构

archive/
├── video.go          # 视频处理核心逻辑
├── image.go          # 图像转换功能
├── audio.go          # 音频处理模块
├── stand.go          # 标准化处理和依赖检查
├── sqlite/           # 数据库存储层
│   ├── model.go      # 数据模型定义
│   ├── sqlite.go     # SQLite 连接管理
│   └── unit_test.go  # 数据库单元测试
└── unit_test.go      # 主要功能测试

🔍 依赖说明

📝 测试

运行单元测试：

go test -v ./...

运行特定测试：

# 测试 MKV 转换
go test -v -run TestConvertMkv

# 测试视频标准化
go test -v -run TestConvertH264

# 测试数据库操作
go test -v -run TestHistoryModel

⚠️ 注意事项

1. 备份重要文件: 转换过程会删除源文件，请确保重要数据已备份
2. 系统资源: 大批量转换会消耗较多 CPU 和内存资源
3. 磁盘空间: 转换过程中需要临时存储空间
4. 权限要求: 确保程序有读写目标目录的权限

🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来改进项目：

1. Fork 项目仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

感谢以下开源项目的支持：

• FFmpeg - 多媒体处理框架
• libavif - AVIF 图像编码库
• MediaInfo - 媒体信息分析工具
• GORM - Go 语言 ORM 框架

Made with ❤️ by zhangyiming748