djvubind(1)

💖 djvubind(1) — bestie edition 💖

okay so first things first: this is the manual page for djvubind, straight out of the General Commands Manual. she's a little command with big main character energy and she's about to make your scanned books look ✨immaculate✨. let's get into it 🫶

---

✨ NAME ✨

djvubind — Create high-quality djvu files, including positional ocr, metadata, and bookmarks.

like. that's the whole vibe. high-quality djvu files. positional ocr. metadata. bookmarks. she does it all 💅

---

🌸 SYNOPSIS 🌸

djvubind [--quiet] [--verbose] [--no-ocr]
         [--bookmarks=<filename>] [--metadata=<filename>]
         [--cover-front=<filename>] [--cover-back=<filename>]
         [--ocr-engine=(tesseract|cuneiform)]
         [--tesseract-options=<string>] [--cuneiform-options=<string>]
         [--title-start=<filename>] [--title-uppercase] [--title-exclude=<filename>:<string>]
         directory

notice the directory at the end, bestie. that one's not optional. she needs to know where the pages are 🎀

---

🦋 DESCRIPTION 🦋

Djvubind facilitates creating high-quality djvu files, especially digital versions of scanned books. she's literally a wrapper, no cap — she combines the djvulibre tools, minidjvu, and various ocr engines together so you get a simple, single command creation of a djvu file. one command. one slay. periodt ✨

---

🎀 TITLE EXAMPLES 🎀

okay so imagine your directory is giving this energy:

page_000.tif, page_001.tif, page002.tif, page_003.tif, page_004.tif

(yes page002.tif is missing an underscore. she said "i'm different" and honestly? respect 💅)

now watch what happens:

command: djvubind --title-start=page_002.tif
titles:  i, ii, 1, 2, 3

command: djvubind --title-start=page_002.tif --title-exclude=page_003.tif:blank
titles:  i, ii, 1, blank, 2

see how that one page just said "not today" and got her own custom title? iconic 🌈

Front and back cover images, if present, are automatically given titles of "cover" and "back cover". and listen — if --title-start is not given, no pages will be titled. that's it. no titles. nada. 🙈

---

💅 OPTIONS 💅

• --bookmarks=<filename> — Specifies an alternate bookmarks file. The format of this file should be similar to what is produced by "djvused -e 'print-outline'". By default, "bookmarks" is used if present.
• --cover-front=<filename> — Specifies an alternate front cover image. By default, "cover_front.jpg" is used if present.
• --cover-back=<filename> — Specifies an alternate back cover image. By default, "cover_back.jpg" is used if present.
• --metadata=<filename> — Specifies an alternate metadata file. The format of this file should be similar to what is produced by "djvused -e 'print-meta'". By default, "metadata" is used if present.
• --no-ocr — Images will not be processed for text content. no ocr. she's just looking at the pictures, respectfully 🍓
• --ocr-engine=(tesseract|cuneiform) — Specifies which ocr engine to use. Tesseract is the default. pick your fighter 👑
• --tesseract-options=<string> — and — --cuneiform-options=<string> — Passes custom options to the respective ocr engine (see their manpages for options). yes you gotta go read those other manpages, bestie, that's the deal 🤝
• --title-start=<filename> — Prior to this image, pages will be titled with roman numerals (i, ii, iii...). Starting with this page, they will be titled with arabic numerals (1, 2, 3...). the glow-up happens right at this file 💫
• --title-uppercase — Roman numeral titles will be in uppercase (I, II, III...). shout it, don't whisper it 📣
• --title-exclude=<filename>:<string> — This image will not be included in sequential page titling. If you want a unique title, append a colon and the title. she gets to sit out the count AND get her own name if she wants. princess behavior, honestly 👑
• -q | --quiet — No status information will be given. silence. serene. 🌙
• -v | --verbose — Additional information will be given, which is intended to help debugging. she's gonna overshare a little. it's for debugging purposes and it's very helpful 🔍

---

👑 AUTHOR 👑

Written by Adam A. Zajac <strider1551@gmail.com>

---

and that's the whole page, bestie 💜 that was djvubind(1) from the General Commands Manual — go forth, bind your djvu files, and be the main character of your own scanning workflow ✨🦋💖