Redaktor
Frequently Asked Questions
Everything you need to know about redacting, verifying, and sharing. No account, no login, no tricks.
Questions and answers
Redaction & Safety
Does Redaktor actually delete the text, or does it just cover it?
Delete. The qpdf-backed engine finds the glyph operators inside the redaction box in the PDF’s content stream and rewrites the file without them. The bytes on disk no longer contain those characters. That is why
pdftotext comes back empty for the region. There is nothing there to extract.Can I trust the "verified" badge?
Redaktor runs two independent checks after writing the output file: it re-extracts text using PDFKit’s selection API (the same channel
pdftotext uses), and it renders the redaction region to pixels and runs Apple Vision OCR over them. The green badge only appears when both come back clean. If either reports residue, the receipt panel lists it.How is Redaktor different from other PDF tools?
Many tools draw black rectangles on top of the text. The text remains underneath and can be recovered via copy-paste or text extraction. That is not redaction, that is decoration. Redaktor edits the PDF content stream directly: only the glyph operators inside your boxes are removed, and the rest of the page stays intact — selection, search, and assistive tech keep working on the unredacted regions. Every export is verified by two independent channels before it is allowed to land on disk.
Can I undo an export?
Every export creates a new file. The original stays unchanged. Inside the app, ⌘Z undoes redaction boxes before you export. Undoing a completed export is intentionally not supported. That protects the integrity of the redacted output.
What happens to the original PDF?
The original is never overwritten. Redaktor always writes the export to the location you pick in the save panel. If you try to overwrite the source file, the app refuses with an error.
Files & Formats
Which PDFs work?
Anything PDFKit can open and qpdf can parse: Latin, CJK, and Arabic text, RTL scripts, embedded fonts, subsetted fonts, Type0 composite fonts, and diacritics. Tested up to 100 pages and 200 MB file size. Encrypted PDFs need to be unlocked first — Redaktor refuses to write an output for a document it cannot safely re-parse.
What about PDF form fields?
Interactive form fields store their values in the
/V entry of the field’s widget annotation, which lives outside the page content stream. Redaktor flattens the form before redaction: PDFKit bakes the widget appearances into the page content stream, and the engine then removes the glyphs inside your boxes along with the rest of the content. In the normal case there is no warning — the form fields are gone from the output. If the automatic flatten fails on an unusually structured AcroForm, the export report warns that form field content may not be fully redacted and asks you to flatten the form yourself in Preview or Acrobat before trying again.I see "image-embedded text" or "OCR detected text" in the receipt. What does that mean?
The text-extraction channel reported clean, so no text scraper will find anything. But Apple Vision OCR detected readable characters in the rendered pixels of a redaction region. Usually this means the PDF contains a scanned image or a raster overlay with baked-in text. The default surgical engine works on the content stream, not on pixel data, so it cannot remove characters from inside an image. Use Flatten as image PDF when this matters: Redaktor renders each page to pixels, burns your redaction boxes into those pixels, and writes a new image-only PDF without source text layers, forms, annotations, or source metadata. Tradeoff: text selection, search, links, forms, and annotations are removed, and the file can become much larger.
I drew a box over outlined text. Why did Redaktor say "0 glyphs removed"?
Outlined text is stored in the PDF as vector paths (lines and curves that happen to look like letters) instead of glyph operators. There is no
Tj / TJ in the content stream to remove. The engine correctly reports zero modifications, and the OCR channel flags the region. Flatten as image PDF is the fallback for this case, with the same tradeoffs: no text selection, no search, and no interactive PDF elements in the export.How long does an export take?
Typical documents (10 to 50 pages) export in seconds. The surgical engine only rewrites the affected content streams; the rest of the PDF passes through untouched. Flatten as image PDF takes longer because it rerenders every page to pixels. A progress bar is shown during export, and you can cancel at any time.
Privacy & Networking
Does the app need an internet connection?
Practically no. The entire redaction pipeline runs offline: PDFKit load, qpdf content-stream rewrite, Apple Vision OCR on rendered regions, file write through NSSavePanel. The app makes network calls only outside the document workflow:
- Apple’s StoreKit for the optional Tip Jar.
- Apple’s SKStoreReviewController for the in-app review prompt.
- An anonymous GET to cagatay.io/apps/catalog.json when you open the Settings window, to populate the More Apps cross-promo list. Response is cached locally.
What is stored locally?
Only a small set of app preferences in UserDefaults inside the macOS sandbox: a successful-export counter and last-shown date for the review-prompt gating, a flag for whether the support-mail dialog includes system info, six flags tracking first-use ambient guidance, and the cached More Apps catalog JSON (capped at 100 KB). No PDF contents, no document paths beyond what macOS keeps in the system Recents list, no analytics, no browser cache.
Are my documents uploaded anywhere?
No. Your PDFs exist solely in your Mac’s memory and are discarded when you close them. There is no cloud backend, no automatic caching, no iCloud sync. The full privacy policy is at cagatay.io/apps/redaktor/privacy.
Purchase & Updates
Is there a subscription?
No. One-time purchase, yours forever. All features are unlocked from the start. The optional Tip Jar in Settings is purely voluntary and does not affect functionality.
Do I get updates?
Yes, free via the Mac App Store, delivered automatically as long as the app is installed.
What macOS versions are supported?
Redaktor requires macOS 14 Sonoma or later. Tested on both Apple Silicon and Intel Macs.
Troubleshooting
Export fails. What now?
Common causes:
- No write access at the chosen location. Pick a different folder.
- Attempting to overwrite the source. Redaktor blocks this; choose a new filename.
- PDF damaged. Open it in Apple Preview and re-export as a new PDF.
- Encrypted PDF. Unlock it first (Preview → Export As, without the password).
The receipt shows "Review required". What does that mean?
Either the text-extraction channel found readable text inside a redacted region, or Apple Vision OCR did. The receipt lists which pages and what residue. Most common causes: the redaction box did not fully cover the sensitive text — widen it by a few points and re-export; or the content was a scanned image or outlined text — use Flatten as image PDF from the receipt to redo the export by burning the boxes into pixels.
Why are there sometimes tiny residue dots near the edge of my redaction?
PDF glyphs can extend a sub-point past the visible selection at the edges (descenders on "g"/"y", italic tails). Redaktor pads every converted rect by 1 pt on each side to catch this. If you still see residue, widen the box by a few more points before exporting.