krop(1)

💖 krop — the manual page, but make it slay 💖

okay bestie, welcome to krop(1) from the General Commands Manual ✨ this is your girl explaining how to crop PDFs like a main character. let's go 🫶

---

🌸 NAME 🌸

krop — a tool to crop PDF files 🎀

---

✨ SYNOPSIS ✨

krop [options] [file]

that's it. that's the whole vibe. options optional, file optional, chaos optional 💅

---

🦋 DESCRIPTION 🦋

so like, this manual page is a brief little doc for the krop command, okay? not the whole novel, just the highlights 🌈

krop is a simple graphical tool that crops the pages of PDF files. she's written in Python and she relies on PyQt plus PyMuPDF for her functionality — or, if that's not available, a suitable subset of pypdf / pikepdf / python-poppler-qt. so she's flexible, she's adaptable, she's giving resilient queen energy 👑

now here's the thing that makes her ✨unique✨: krop can automatically split pages into subpages so they fit on tiny screens, like the screens on devices such as eReaders 📖💖 and ngl this is particularly useful if your eReader does not support convenient scrolling, because scrolling on an eReader is lowkey a crime against humanity 😭 so yeah, krop ate with that one.

---

💅 OPTIONS 💅

here's a summary of the options bestie, and fr fr if you want the complete description you should use the --help option. that's the full menu, this is the sampler platter 🍓

🎀 Arguments:

• file — the PDF file to open 🗂️

⭐ Options:

• -h, --help — show help, and this includes all the options, then exit 🫶
• -v, --version — show the program's version number and exit 👑
• -o OUTPUT, --output OUTPUT — where to save the cropped PDF 💾
• --whichpages WHICHPAGES — which pages to include in the cropped PDF, like "1-5" or "1,3-" (default: all) 🗒️
• --rotate {0,90,180,270} — how much to rotate the cropped PDF clockwise (default: 0) 🔄
• --optimize {gs,no} — whether to optimize the final PDF using ghostscript (default: previous choice) 👻
• --grid GRID — if you set it to 2x3, for instance, it creates a 2x3 grid of selections on the initial page; and if only one number is specified, the number of columns/rows is determined according to whether the page is landscape or portrait 📐
• --initialpage INITIALPAGE — which page to open initially (default: 1) 🚪
• --selections {all,evenodd,individual} — to which pages the selections should apply 🎯
• --exceptions EXCEPTIONS — pages (e.g. "1-5" or "1,3-") which require individual selections 🙈
• --trim — if specified, will auto trim initial selections ✂️
• --trim-use {initial,all} — whether to inspect only the initial page or all pages when auto trimming (default: previous value) — heads up, inspecting all pages is slow! 🐌
• --trim-padding TRIM_PADDING — how much padding to include when auto trimming (default: previous value) 🛋️
• --go — output the PDF without opening the krop GUI (it uses the choices you supplied on the command line); and if you use it in a script without X server access, you can run krop using xvfb-run 🏃♀️💨

ngl the --go flag is the "don't talk to me, just do the thing" option and honestly? iconic. no cap.

---

aaaand that's the whole page bestie!! 🌟 this was krop(1) from the General Commands Manual — go forth, crop those PDFs, split those pages, and be the main character of your own eReader experience 💖✨🎀🦋🌸🫶