OCRAD(1)

📦
version 0.29 · 3 versions
, in arch rolling, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 OCRAD — like, the optical text recognition tool, bestie 💖

okay so you know how sometimes you have an image of text and you're like "ugh I can't copy-paste this"? yeah. that's what ocrad is for. it's the GNU Ocrad situation, a manual-page situation, and honestly? iconic. it lives in the User Commands corner of your system and it's here to turn pixels into words. periodt.

✨ NAME ✨

ocrad — optical text recognition tool 🫶

🌸 SYNOPSIS 🌸

ocrad [options] [files]

🦋 DESCRIPTION 🦋

GNU Ocrad is an OCR — that's Optical Character Recognition, no cap — program based on a feature extraction method. It reads images in png or pnm formats and produces text in byte (8-bit) or UTF-8 formats. and bestie, the formats pbm (bitmap), pgm (greyscale), and ppm (color) are collectively known as pnm. so there you go. 💅

Ocrad includes a layout analyser able to separate the columns or blocks of text normally found on printed pages. the way it just knows where your columns are? main character energy fr fr.

For best results the characters should be at least 20 pixels high. if they're smaller, try the option --scale. Scanning the image at 300 dpi usually produces a character size good enough for ocrad. 🌈

Merged, very bold, or very light (broken) characters are normally not recognized correctly. Try to avoid them. like, please. for me. 🙈

👑 OPTIONS 👑

  • -h, --help — display this help and exit
  • -V, --version — output version information and exit
  • -a, --append — append text to output file
  • -c, --charset=<name> — try --charset=help for a list of names
  • -e, --filter=<name> — try --filter=help for a list of names
  • -E, --user-filter=<file> — user-defined filter, see manual for format
  • -f, --force — force overwrite of output file
  • -F, --format=<fmt> — output format (byte, utf8)
  • -i, --invert — invert image levels (white on black)
  • -l, --layout — perform layout analysis
  • -o, --output=<file> — place the output into <file>
  • -q, --quiet — suppress all messages
  • -s, --scale=[-]<n> — scale input image by [1/]<n>
  • -t, --transform=<name> — try --transform=help for a list of names
  • -T, --threshold=<n> — threshold for binarization (0.0-1.0)
  • -u, --cut=<l,t,w,h> — cut the input image by the rectangle given
  • -v, --verbose — be verbose
  • -x, --export=<file> — export results in ORF format to <file>

🧚 THE DEETS (iykyk) 🧚

If no files are specified, or if a file is -, ocrad reads the image from standard input. If the option -o is not specified, ocrad sends text to standard output. so simple. so clean. we love a flexible stdin situation. 💜

💀 EXIT STATUS 💀

like, here's the vibe check on how it leaves:

  1. 0 — a normal exit ✨
  2. 1 — environmental problems (file not found, invalid command-line options, I/O errors, etc)
  3. 2 — to indicate a corrupt or invalid input file 😭
  4. 3 — for an internal consistency error (e.g., bug) which caused ocrad to panic. yes. panic. it's giving chaos, honestly.

🔥 REPORTING BUGS 🔥

Found a bug? don't be shy, tell the devs bestie:

Copyright © 2024 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. like literally none. zero. nada. 🙈

⭐ SEE ALSO ⭐

The full documentation for ocrad is maintained as a Texinfo manual. If the info and ocrad programs are properly installed at your site, the command

info ocrad

should give you access to the complete manual. go read it, it's a whole thing. 📖✨

k bye bestie!! this page is from GNU ocrad 0.29, dated January 2024, and it served. stan an OCR tool that keeps it real. 💖🦋👑

📦 where this page comes from