FACEDETECT(1)

📦 version 0.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 FACEDETECT 💖

okay bestie, welcome to the facedetect page from the User Commands girlies 💅 this is the one you want when you've got a folder full of pics and you need to know which ones have a whole entire human face in them. let's get into it 🫶

✨ NAME ✨

facedetect — your simple little face detector for batch processing 🎀

🌸 SYNOPSIS 🌸

facedetect [-h] [--biggest] [--best] [-c] [-q] [-o OUTPUT] [-d] file

🦋 DESCRIPTION 🦋

Facedetect is a simple face detector for batch processing, and honestly? it's iconic for that. it answers the most basic question ever: "Is there a face in this image?" 😭 and then it gives you back either an exit code or the coordinates of each detected face in the standard output. that's it. that's the whole vibe.

the aim — and this is the lowkey important part — is to provide a basic command-line interface that's consistent and easy to use with software such as ImageMagick, while progressively improving the detection algorithm over time. so like, it plays nice with the other tools in your group chat 💜

and no cap, facedetect is used in software such as fgallery to improve the thumbnail cutting region, so that faces are always centered. main character framing, periodt 👑

✨ OPTIONS ✨

🎀 positional arguments:

  • file — Input image file 📸 the actual pic you're feeding in, bestie

💅 optional arguments:

  • -h, --help — show this help message and exit. the classic "wait what do i do" button, always there for you 🫶
  • --biggest — Extract only the biggest face. one (1) face gets the spotlight, and it's the largest one 👑
  • --best — Extract only the best matching face. the algorithm picks its fave, and honestly? slay 💖
  • -c, --center — Print only the center coordinates. skip the extras, just give me the coordinates 🎯
  • -q, --query — Query only (exit 0: face detected, 2: no detection). literally just a vibe check: face? exit 0. no face? exit 2 🧚
  • -o OUTPUT, --output OUTPUT — Image output file. where the output image goes, you decide 💾
  • -d, --debug — Add debugging metrics in the image output file. for when you need the receipts 🔍

🌈 AUTHOR 🌈

this manpage was written by Andreas Tille for the Debian distribution, and can be used for any other usage of the program. ty for your service 🫡

okay that's the whole page bestie, no notes 💀

and that's a wrap! this was facedetect 0.0.+20150428, dated April 2016 🌸 so yeah, it's been serving face (detection) since then. go detect some faces, you've got this 💖✨🦋🎀💅

📦 where this page comes from