leblancfg/autocrop

📸 Automatically detects and crops faces from batches of pictures.

What it solves

Autocrop 是一个设计用来自动化裁剪图像以聚焦人脸的工具。它通过自动检测图像中最大的脸部并将裁剪中心对准该脸部，省去手动裁剪头像或身份证照片的繁琐工作。

How it works

该工具使用 OpenCV 的 YuNet 神经网络人脸检测器（具体为 face_detection_yunet_2023mar.onnx 模型）来定位图像中的人脸。它可以作为 Python API 或命令行界面（CLI）使用，允许用户指定输出尺寸、缩放选项，以及人脸在图像高度中所占的百分比。

Who it’s for

此工具面向需要批量处理网站、身份证或其他需要以人脸为中心裁剪的应用场景的开发者和系统管理员。

Highlights

  • 拥有 CLI 和 Python API，灵活集成。
  • 支持多种输入和输出图像格式。
  • 通过捆绑 YuNet 检测模型，实现离线运行。
  • 可与 find、xargs、parallel 等 shell 工具组合，进行大批量批处理。
  • 支持通过 ffmpeg 从视频文件中提取的帧进行处理。