Design · 2026-11-04 · 9 min

Why a squid redacts PDFs in Inkfish

A black rectangle drawn over a PDF is a terrible progress indicator. It tells you that a line of text looks hidden on your monitor right now. It tells you nothing about whether the underlying PDF content stream was actually deleted, whether the same Social Security number or bank account appears again on page 14, or whether anyone reopened the saved file to test if the text can still be copied out.

Inkfish uses a flat orange squid to make those invisible states obvious. When you drop a PDF into the window, the squid swims down the left patrol lane with a magnifier while pages are scanned, hovers beside a highlighted candidate when you step through the review list, charges up and sprays dark ink across confirmed boxes when writing a new -redacted.pdf copy, and settles into a squinting smile once the post-save verifier finishes checking the file.

PDF redaction is the permanent removal of selected text and graphics from the underlying content stream of a shared PDF copy, followed by reopening the saved file to verify that no visible or extractable characters remain under any covered area. Drawing an opaque black shape in a markup toolbar only adds a visual annotation layer while leaving the selectable text intact underneath.

Where the metaphor helps, and where it has to stop

The idea started from a simple biological habit: when a real squid feels watched, it shoots a cloud of dark ink to hide and jets away. When you are preparing a signed consulting agreement, a residential lease, or a bank statement on a Mac, you are trying to do the same thing for a handful of private identifiers before handing the document to a client, a landlord, or an AI chat window.

If a short PDF only has one or two numbers to remove, you do not need Inkfish at all. macOS Preview includes Redaction Selection (Tools → Redact). As Apple’s Preview annotation guide notes, closing the window commits the redaction and deletes the covered content, though Apple also warns that table-of-contents entries pointing to redacted text are not removed automatically. Because Preview saves redactions destructively in place, you have to duplicate the file in Finder first.

The workflow breaks down when a 25-page contract repeats a client’s name and IBAN ten times, mixes in a scanned signature page with no text layer, or combines US, European, and Chinese identifier formats. Hunting for every repeat by eye and hoping the save worked is nerve-wracking.

Giving that job to an animated squid only works if the character obeys a strict boundary: the squid explains what the app is doing, while the file pipeline does the actual deletion and verification.

Mapping four squid motions to four file states

A mascot inside a utility app becomes annoying the moment it dances for no reason or delays your work. Every animation loop in Inkfish is tied to a specific state in the detection and redaction engine:

Workflow stageWhat the squid does on screenQuestion the interface is answering
ScanSwims down the left margin with a magnifier as the scan line sweeps the pageWhich page is being read right now, and how many candidates have been found so far? (On PDFs over 50 pages, the squid patrols only the first 3 pages and pages with findings so it never slows down a long file.)
ReviewRests beside the page; swims to the exact line and nods when you hover or arrow-key through the findings listWhere on the page does this specific phone number, IBAN, or name actually sit, and should it stay ticked?
WriteTurns toward the page, charges up, and sprays ink across each confirmed box when you press Ink N items (⌘↩)Which selected coordinates are being written into the new -redacted.pdf copy right now?
VerifySettles into a finished pose while the summary panel lists verification resultsWhere was the safe copy saved, did every redacted box pass the post-save text extraction check, and did any page fail?
Character motion study
Looping study of the orange squid inspecting with a magnifier

Inspect & point-to-locate

Moving through the sidebar sends the squid to the matching coordinate on the page so you can verify context before inking.

Looping study of the orange squid turning sideways to spray ink

Spray confirmed selections

The ink burst tracks write progress while the PDF engine removes covered text from a new copy on disk.

Looping study of the orange squid celebrating at the end of a task

Report post-save verification

Once writing ends, the done panel reports where the safe copy lives and whether any page needs to be redone as an image.

These loops communicate workflow state; they never substitute for post-save file verification. Enabling macOS Reduce Motion switches the app and these cards to still frames.

Ink is visual feedback; the verifier checks the saved bytes

The ink droplets stop at the Metal rendering layer. What makes the output safe to send happens in the PDF pipeline underneath.

When you press ⌘↩, Inkfish never overwrites your source PDF. It writes a separate -redacted.pdf file, removes the selected text from the page content stream, and optionally strips document metadata, hidden text and optional content layers, comments, form field values, and embedded attachments. Immediately after saving, Inkfish’s Verifier reopens that newly written file from disk and tests every redacted rectangle to confirm that zero characters can be extracted underneath. If a page with unusual font encodings fails that check, Inkfish flags the exact page number and provides a one-click Redo page as image fallback that flattens the page into a bitmap with the covers burned in. We cover the stream-level mechanics in our Mac PDF redaction guide and the OCR coordinate quirks in our scanned PDF redaction checklist.

Automated verification still has one hard limit: it can only test locations that were selected for removal. It cannot guess that an unmarked project codename on page 3 was supposed to be secret, and a text-stream check cannot see exposed pixel remnants on an image-only scan. Before sending a high-stakes document out the door, run through this five-step check (or paste it to a colleague for a second pair of eyes):

Pre-delivery check for the saved -redacted.pdf copy:
1. Open the saved -redacted.pdf file fresh from Finder; do not just look at the active editing window.
2. Press Cmd+F and search for the full removed strings plus a 4-character fragment of each.
3. Press Cmd+A, copy all page text into a plain-text editor, and scan for unredacted repeats on later pages.
4. On scanned or signed pages, zoom to 200% and check the edges of every black box for clipped ascenders or descenders.
5. Open Preview's Inspector (Cmd+I) to confirm document title, author metadata, comments, attachments, and the filename itself are clean.

Why we built regional rule packs instead of a “GDPR compliance toggle”

In an early sketch of Inkfish, we considered adding checkboxes labeled “GDPR Mode,” “HIPAA Mode,” and “PIPL Mode.” We threw that idea out before writing a line of detection code.

Whether a specific field must be removed from a document depends on your jurisdiction, your organization’s retention rules, and why you are sharing the file in the first place. Sending a lease to a mortgage underwriter requires different fields than uploading the same lease to an LLM to summarize the maintenance clauses. No offline utility can compress legal compliance into a checkbox.

Instead, Inkfish combines deterministic regional and industry rule packs with an 11 MB bundled local PII model:

Detection layerWhat it finds on your MacWhat still requires human judgment
Regional rule packs (US, EU, UK, Mainland China)Structured formats and checksums: US SSN & ITIN, European IBAN & national IDs (DE, FR, ES, IT, NL), UK NIN & NHS numbers, Chinese 18-digit resident ID & Unified Social Credit CodeWhich jurisdiction applies to the document, and whether the recipient legitimately needs a given number
Industry rule packs (Finance, Healthcare)Luhn-validated payment cards, CVV, ABA routing, SWIFT/BIC, medical record numbers (MRN), NPI, MBI, DEA, ICD-10 codesInternal data-handling policies, client consent scope, and legal retention duties
Bundled 11 MB PII model + Apple NLPUnstructured person names, street addresses, and organizations in English, Chinese, and German prose or Vision OCR textWhether a model suggestion flagged a harmless phrase (such as a street-like meter label), and which items to keep ticked
Manual boxes & custom rulesHand-drawn Mark area rectangles, or Add rule text and regex matches for internal project codenamesChecking that boxes cover full glyphs on scanned pages and that every repeat is selected

Rule-only findings display their confidence score (items at or above 85% start ticked by default), while local-model findings display their source (Local model suggestion) rather than a made-up percentage. The detector’s job is to answer “where might private data be hiding on these pages?” Your job is to decide what leaves the building. This article describes product design, not legal advice.

Playfulness stays optional (and under 2 ms on the main thread)

A character can lower the stress of a tedious review, or it can become visual clutter when you are on your twentieth file of the afternoon. To keep the squid from getting in the way, we built three engineering guardrails into the window:

  • Page progress (Page N of M · K found), confidence scores, model source badges, output file paths, and verification warnings all live in standard SwiftUI text controls. The squid canvas is explicitly hidden from the macOS accessibility tree (VoiceOver), so screen-reader users get clean status announcements without decorative noise.
  • If you uncheck Show the squid in Settings → General (or turn on macOS Reduce Motion), Inkfish immediately unloads the sprite textures, shrinks the Metal drawables, and runs the exact same scan, review, redaction, and verification flow without the character.
  • Even at the peak of an ink burst, the squid simulation takes under 2 ms on the main thread, and mouse clicks pass straight through the layer everywhere outside the squid’s body.

For a one-page PDF with a single phone number, macOS Preview’s built-in Redact tool is still the fastest path. When you are dealing with multi-page contracts, regional ID formats, or scanned pages that need post-save verification, see the Inkfish user guide. The squid makes the process easier to follow; stream-level deletion, automated verification, and your final review make the file safe to send.

Common questions

Does the squid’s ink spray just draw black rectangles over the PDF?

No. The ink spray is visual progress feedback in the app window. When you click Ink N items (⌘↩), Inkfish writes a new -redacted.pdf copy, deletes the covered text from the underlying PDF content stream, and immediately reopens the saved file from disk to verify that no text can be copied, searched, or extracted from any redacted box.

Can I turn off the animated squid in Inkfish?

You can turn it off at any time in Settings → General by unchecking Show the squid, or by enabling Reduce Motion in macOS System Settings. Turning the squid off releases its sprite textures from memory while keeping on-device PII detection, OCR, content-stream redaction, and post-save verification identical.

What happens if a PDF page fails Inkfish’s post-save verification check?

If the post-save verifier detects any extractable character remaining under a redaction box (which can happen with certain non-standard embedded fonts or complex vector layers), the completion panel names the exact page and provides a one-click Redo page as image fallback. That action rasterizes the affected page with the black covers burned into the image pixels so no underlying text layer remains on that page.

Inkfish app icon

More notes