Video Organizer

视频文件批量重命名和整理工具，支持按时间、格式、分辨率等方式整理视频，批量重命名，预览模式和撤销功能！

Security Scan

The skill's code, instructions, and requirements are coherent with a local video-file organizing/renaming tool and do not request unexplained credentials or network access.

Purpose & Capability

Name/description (batch rename and organize videos) match the code and SKILL.md. The skill only performs local file operations (organize, rename, preview, undo) and does not request unrelated capabilities or credentials.

Instruction Scope

SKILL.md instructions align with the implemented behavior: operate on a given directory, offer preview/confirm prompts, save a local backup file and support undo. The instructions reference only local paths and usage of the included Python script; they do not instruct reading unrelated system files or sending data externally.

Install Mechanism

No install spec is provided (instruction-only). Source includes a Python script that can be run locally; nothing is downloaded from external URLs or installed automatically, which reduces risk.

Credentials

No environment variables, credentials, or external config paths are requested. All required inputs are local directory paths as expected for a file-organizing tool.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide agent settings. It writes a local backup file (.video-organizer-backup.json) into the output directory and performs file copy/rename operations — expected behavior for this functionality.

Assessment

This tool appears to do exactly what it says: local file operations to organize and rename videos with preview and undo support. Before using it: (1) run with --preview first to confirm planned changes; (2) test on a small sample folder; (3) note it creates a local backup file (.video-organizer-backup.json) in the output directory — keep or move that file if it contains mappings you care about; (4) the code performs copy (organize) or rename (rename/undo) operations locally and does not transmit data externally; (5) the package author/source is unknown — if you require higher assurance, review the script yourself or run it in a controlled environment.

Video Organizer - 视频文件批量重命名和整理工具

功能特性

• ✅ 自动识别视频文件格式（mp4, avi, mov, mkv, flv, wmv, webm 等）
• ✅ 按时间整理（文件修改时间）
• ✅ 按格式/扩展名整理
• ✅ 按分辨率整理（720p, 1080p, 4K 等，可选）
• ✅ 批量重命名（支持多种命名模式、正则表达式）
• ✅ 预览模式（先看效果再执行）
• ✅ 撤销操作（安全可靠）

安装

# 方法一：通过 clawhub 安装
clawhub install video-organizer

# 方法二：作为 Python 脚本运行
git clone <repo-url>
cd video-organizer

快速开始

1. 按时间整理视频

video-organizer organize ./videos --by date --output ./organized

2. 按格式整理视频

video-organizer organize ./videos --by format --output ./organized

3. 批量重命名视频

video-organizer rename ./videos --pattern "video_{001}.mp4"

4. 预览模式

video-organizer organize ./videos --by date --preview

5. 撤销操作

video-organizer undo ./organized

详细使用说明

organize 命令参数

• directory：（必需）要整理的视频目录
• --by：整理方式，可选 date（按时间，默认）或 format（按格式）
• --output：输出目录，默认在输入目录下创建 organized 文件夹
• --preview：预览模式，只显示方案不实际执行

rename 命令参数

• directory：（必需）要重命名的视频目录
• --pattern：（必需）命名模式
• --regex：正则表达式替换
• --preview：预览模式

支持的视频格式

格式	说明
mp4	MP4 视频
avi	AVI 视频
mov	QuickTime 视频
mkv	Matroska 视频
flv	Flash 视频
wmv	Windows Media 视频
webm	WebM 视频

示例场景

场景 1：整理下载的视频

# 按时间整理下载文件夹里的视频
video-organizer organize ~/Downloads --by date --output ~/Videos/Organized

场景 2：批量重命名视频

# 将视频重命名为 video_001.mp4, video_002.mp4...
video-organizer rename ./videos --pattern "video_{001}.mp4"

场景 3：先预览，再执行

# 第一步：预览
video-organizer organize ./videos --by format --preview

# 第二步：确认没问题后执行
video-organizer organize ./videos --by format --output ./organized

注意事项

• 确保有文件的读写权限
• 建议先用 --preview 预览效果
• 大量文件整理可能需要一些时间
• 整理前建议先备份原文件

更新日志

v1.0.0 (2026-03-06)

• 初始版本发布
• 支持按时间/格式整理
• 支持批量重命名
• 支持预览模式
• 支持撤销操作