HOCR(1)

🌸 NAME 🌸

okay bestie, so hocr is a Hebrew OCR utility 💖 that's it that's the whole vibe — it reads Hebrew text off your images and turns it into actual text. we're in section 1 of the manual, iykyk ✨

---

✨ DESCRIPTION ✨

like literally the most iconic little OCR bestie you'll ever meet 🫶 here's how you run her:

hocr [OPTION...] - Hebrew OCR utility

🎀 Help Options

the "wait what does this do again" squad 🫶

• -?, --help — shows you the help options, no cap
• --help-all — shows you all the help options, every last one 💅
• --help-file — shows just the file options
• --help-image-proccesing — shows just the image proccesing options
• --help-segmentation — shows just the segmentation options
• --help-debug — shows just the debug options

🍓 File options

where does everything go, and what do we keep? 🎀

• -O, --images-out-path=PATH — use PATH for the output images, that's the spot
• -u, --data-out=FILE — use FILE as the output data file name
• -C, --save-copy — saves a compy of the original image 🙈 (yes, compy. she's cute, we keep her)
• -b, --save-bw — saves the proccesd bw image
• -B, --save-bw-exit — saves the proccesd bw image and then dips (exits)
• -l, --save-layout — saves the layout image
• -L, --save-layout-exit — saves the layout image and then exits, bye 👋
• -f, --save-fonts — saves fonts
• -F, --save-fonts-exit — saves the fonts images and exits, periodt

🦋 Image proccesing options

this is where you tune the actual looking-at-the-picture part 🔥

• -T, --thresholding-type=NUM — thresholding type: 0 normal, 1 none, 2 fine
• -t, --threshold=NUM — use NUM as the threshold value, range is 1..100
• -a, --adaptive-threshold=NUM — use NUM as the adaptive threshold value, 1..100
• -s, --scale=SCALE — scales the input image by SCALE from 1..9, or 0 for auto
• -S, --no-auto-scale — do not auto acale the image, she stays as-is
• -q, --rotate=DEG — rotate the image clockwise, in deg.
• -Q, --no-auto-rotate — do not auto rotate the image

💅 Segmentation options

chopping the page up so it actually makes sense, main character energy fr fr

• -c, --columns setup=NUM — columns setup: 1.. #columns, 0 auto, 255 free
• -x, --slicing=NUM — use NUM as the font slicing threshold, 1..250
• -X, --slicing-width=NUM — use NUM as the font slicing width, 50..250
• -w, --font-spacing=NUM — font spacing: tight at ..-1, 0, and spaced at 1..

🐛 Debug options

for when you're being nosy about what she's doing 🔍 obsessed

• -g, --draw-grid — draws a grid on the output images
• -d, --debug — prints debugging information while running
• -D, --debug-extra — prints extra debugging information, extra nosy
• -y, --font-filter=NUM — debugs a font filter, use filter NUM
• -Y, --font-filter-list — prints a list of debug a font filters
• -j, --font-num-out — prints font numbers in the output text

💖 Application Options:

the main event, the core four-ish 🫶

• -i, --image-in=FILE — use FILE as the input image file name
• -o, --text-out=FILE — use FILE as the output text file name
• -h, --html-out — outputs the text in html format, fancy 💅
• -N, --no-gtk — do not use gtk for file input and output
• -z, --font=NUM — use font NUM
• -n, --no-nikud — do not recognize nikud
• -v, --version — prints version information and exits

---

🌈 okay the legal bit, bestie — keeping it exactly as written because copyright is not a vibe to freestyle on:

libhocr-0.10.5-i686-pc-linux-gnu-12022008 http://hocr.berlios.de Copyright (C) 2005-2008 Yaacov Zamir <kzamir@walla.co.il>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

🔥 SEE ALSO

go say hi to the other OCR girlies 💜

• gocr(1)
• ocrad(1)
• unpaper(1)

---

and that's the whole manual, bestie 🎀 this hocr - Hebrew OCR utility page is dated February 2008, and the build tag on it is libhocr-0.10.5-i686-pc-linux-gnu-12022008 — mwah, iconic, no notes 💅✨