NVIDIA AV1 Video Compressor

NVIDIA AV1视频批量压缩工具，使用FFmpeg调用NVIDIA NVENC硬件编码，支持智能压缩验证和多方案选择

li_nvvideocodec - NVIDIA AV1 视频压缩工具

🌍 多语言支持 / Multi-Language Support

本工具支持10种语言：

语言	代码	文档路径
🇺🇸 English	en	locales/en/README.md
🇯🇵 日本語	ja	locales/ja/README.md
🇰🇷 한국어	ko	locales/ko/README.md
🇨🇳 简体中文	zh-CN	locales/zh-CN/README.md
🇹🇼 繁體中文	zh-TW	locales/zh-TW/README.md
🇫🇷 Français	fr	locales/fr/README.md
🇩🇪 Deutsch	de	locales/de/README.md
🇪🇸 Español	es	locales/es/README.md
🇷🇺 Русский	ru	locales/ru/README.md
🇸🇦 العربية	ar	locales/ar/README.md

📋 功能简介

使用NVIDIA GPU硬件加速的AV1视频批量压缩工具，可以：

• 🎯 智能验证 - 自动测试压缩效果，避免无效压缩
• 📊 三种方案 - 保守/平衡/激进，满足不同需求
• 🖥️ 双平台 - 支持Windows和Ubuntu Linux
• 📈 实时进度 - 显示压缩进度和详细统计
• 🔒 安全保护 - 原文件不删除，输出到独立目录

兼容Agent: hermes, openclaw, qwen-code

🚀 快速使用

基本用法

# 交互式模式（会引导你选择参数）
python scripts/compress_videos.py

# 指定目录和方案
python scripts/compress_videos.py -i "输入目录" -p B

# 测试模式（只压缩1个视频验证）
python scripts/compress_videos.py -i "输入目录" -p B --test --test-count 1 --no-confirm

# 完整压缩（非交互）
python scripts/compress_scripts/compress_videos.py -i "输入目录" -p B --no-confirm

📊 压缩方案

方案	分辨率	CRF	帧率	音频	预估节省	适用场景
A	保持原样	23	保持	128k	40-60%	追求质量
B ⭐	1280x720	24	24fps	96k	65-75%	平衡推荐
C	1280x720	28	15fps	64k	78-85%	最大节省

⚙️ 系统要求

必需

• ✅ FFmpeg - 需要支持av1_nvenc编码器
• ✅ NVIDIA GPU - GTX 1650及以上（支持NVENC）
• ✅ NVIDIA驱动 - 已安装并正常工作
• ✅ Python 3.7+ - 运行脚本

可选

• tqdm库 - 显示进度条（脚本会自动安装）

安装FFmpeg

Windows:

# 下载: https://ffmpeg.org/download.html
# 解压后将ffmpeg.exe添加到PATH

Ubuntu:

sudo apt update
sudo apt install ffmpeg

📝 完整参数

参数	简写	说明	示例
--input	-i	输入视频目录	-i "E:\视频"
--output	-o	输出目录	-o "F:\压缩后"
--profile	-p	压缩方案 (A/B/C)	-p B
--test		测试模式	--test
--test-count		测试文件数	--test-count 5
--no-confirm		跳过确认	--no-confirm

🔍 工作流程

1. 环境检查
   ↓
   检查FFmpeg、GPU、编码器支持
   ↓
2. 选择压缩方案
   ↓
   A（保守）/ B（平衡）/ C（激进）
   ↓
3. 验证压缩效果
   ↓
   测试压缩1个小视频，对比大小
   ↓
4. 智能判断
   ↓
   如果有效 → 继续批量压缩
   如果无效 → 提示取消任务
   ↓
5. 批量压缩
   ↓
   显示进度、统计信息
   ↓
6. 生成报告

⚠️ 重要提示

B站视频等特殊情況

如果视频来自B站（Bilibili）等平台：

• 这些视频已被高度压缩（低码率）
• AV1压缩可能不会节省空间
• 脚本会自动检测并提示

原文件保护

• ✅ 原文件不会删除
• ✅ 压缩文件输出到独立目录
• ✅ 可以安全对比测试

📞 技术支持

如遇问题，请检查：

1. NVIDIA驱动是否正常（nvidia-smi）
2. FFmpeg是否安装（ffmpeg -version）
3. FFmpeg是否支持av1_nvenc（ffmpeg -encoders | grep av1_nvenc）

📄 许可证

作者: 北京老李 (beijingLL)