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 などのシェルツールと組み合わせて大量バッチ処理が可能。
  • ffmpeg を使用して動画ファイルから抽出したフレームの処理もサポート。