RELEASES

Shipped, one careful build at a time.

What's new in ShabuBox. Every note lands on a real detail — no “various improvements.”

2.5.0 latest September 2026
Get ShabuBox
Your documents, read again — better, and honestly about it.
NEW

Better table reading — printed table rows are rebuilt from the page's own layout, so a bill's ENDING BALANCE stays attached to its own figure instead of drifting to the next line. When a first reading of a page comes back thin, ShabuBox tries a sharper one and keeps whichever reads better.

NOTE

A one-time background re-read — the first launch after upgrading starts re-reading your existing library in the background. The app stays usable throughout, it resumes wherever it stopped if you quit, results sharpen as it goes, and it only ever replaces text it improved. Typically overnight for a large library; the sidebar shows progress. Documents iCloud has moved off your Mac are fetched and re-read when they arrive, not skipped.

Answers about money come from the right line.
FIX

The right figure from the right document — a total printed beside its adjustments no longer contributes the wrong column; the passage that actually carries an amount makes it into consideration instead of being crowded out; a single form box is answered rather than summed; and the same bill from different months is told apart by date even when the filename has no leading zeros.

FIX

Same question, same answer — an identical question no longer surfaces a different supporting passage after a relaunch when two passages tied exactly. Ties resolve the same way every time.

One Files browser, everywhere.
NEW

The Inbox is a view of Files — same rows, selection, bulk bar and row menu, so everything you can do to a filed document you can do to an inbox one: rename, tag, refile, Generate titles, Reduce Resolution. Searches, Addresses, Entities and a pin on the Map open the same full browser with sorting, filtering, split view and bulk actions.

NEW

Select all N — with a page selected, one click escalates to the whole filtered set. In split view a click moves the preview cursor without disturbing your selection.

The scanner explains itself before it fails.
NEW

Pick your scanner — Settings → Scanner lists every scanner ShabuBox can see, marks which are supported, remembers your choice, and names it in the Inbox's Scan menu. A ScanSnap on USB is never passed over for a network scanner. The ScanSnap iX2500 joins the supported list.

FIX

Diagnosed, not timed out — a scanner that is busy, held by ScanSnap Home, unresponsive because its Wi-Fi is on, or blocked by macOS is named immediately with the fix, instead of a two-minute wait ending in a generic error. The diagnostic report now includes the USB bus.

Two Macs, one library — without erasing each other.
FIX

Curation merges instead of overwriting — stars, notes, tags, custom fields and collections edited on two Macs sharing an iCloud library used to erase each other in turn. Every edit is now stamped per field and a merge can no longer delete the other Mac's change.

NEW

Conflict copies are parked — an iCloud "conflicted copy" is set aside in the Trash, named as such, instead of being indexed as a second document.

NEW

Share this Mac's search index — an off-by-default switch under Settings → General publishes this Mac's index into the library for your other devices, shows how much space each Mac's index takes, and lets you remove one. A second experimental switch under Curation Sync lets this Mac apply edits made on your other devices.

Guards around the library.
FIX

An older ShabuBox can't damage a newer library — the app refuses to open a library last used by a newer version, and says so, instead of silently rebuilding its index without the newer columns.

FIX

A full disk is not a corrupt library — the two are told apart at launch and the library is left untouched when the disk is full. Repair Library lists the index backups it set aside so you can reclaim the space, and a rescan stops and asks when the whole library folder disappears rather than treating every document as deleted.

NOTE

Quieter logs — file names and document contents no longer appear in the system log in the clear.

2.4.0 August 2026
Scan without touching the mouse, and shrink what you keep.
NEW

Watch scanner — press the scan button on the scanner itself, or just drop paper in the feeder, and ShabuBox starts the scan for you. No need to switch back to the app first.

NEW

Reduce Resolution — shrink scanned PDFs in place, one document or in bulk with a cancel button. Size is measured before and after so you can see what you saved, and the pass only ever shrinks — never enlarges — a page. It's permanent — the library file is the only copy — so ShabuBox asks first.

A split view built for skimming.
NEW

Split view — your document list sits beside a full-height live preview, so you can page through a stack of scans without opening each one. Arrow keys move the cursor and the preview follows.

Pages land right-side up, edges land clean.
FIX

Smarter auto-rotation — orientation is now decided by the axis of the text itself first, with sparse pages that used to get flipped wrong now recovered correctly.

FIX

Edge-shadow trim — the thin tapered shadow that sheet-fed scanners leave along one edge is shaved off, instead of riding along as a dark sliver on every page.

When the scanner jams, ShabuBox helps you get back to scanning.
NEW

Jam recovery — a stuck feed is detected and surfaced with a Reset Scanner action, instead of a scan that silently stalls.

NEW

ScanSnap conflict detection — ShabuBox notices when ScanSnap Home is holding the scanner and walks you through the fix, including a Quit for me button and the Apple Events permission prompt it needs.

NEW

Save Diagnostic Bundle — one action packages the logs a scanner problem needs, ready to attach to a support email.

Find Anything gets sharper, and Finder tags come along for the ride.
NEW

Find Anything filter mode — the ⌘K palette can now run as a natural-language filter, with a See All Results view that lands in the Searches sidebar and a plain-English explanation of why each match qualified.

NEW

Finder tags import — every way a file can enter your library — drag-in or watched folder — now carries its Finder tags with it, instead of only some of them.

iCloud sync, and truer color underneath.
NEW

iCloud sync — opt in with Sync with iCloud under Settings → General (Library & Storage) to keep your library current across Macs, and opt back out just as cleanly; ShabuBox always shows you the honest state of what has and hasn't synced.

FIX

Color fidelity — the capture mode you scanned with now travels with the page through processing, and grayscale or line-art originals are kept to a single color channel instead of being upsampled to color.

NEW

Byte-identical rescan dedupe — rescanning the same page twice is recognized and skipped instead of adding a duplicate.

Anonymous usage statistics — on by default, off with one switch.
NEW

Anonymous usage statistics — ShabuBox now sends anonymous counts of which screens and features get used and how often, along with your app version, macOS version, Mac model, language and region, so development effort goes where it actually helps. Everything is tied to a random install ID that is hashed before it leaves your Mac. It goes to our own service and to no third party.

NOTE

What it never contains — your documents, file names, folder paths, note text, search queries, tag or entity names, addresses, chat messages, or anything else you typed. No IP addresses are stored and no location is collected. The app can only emit events from a fixed, published list, and every value on them is a preset code, a true/false flag, or a count rounded into a range — so there is no code path that could carry your text.

NOTE

Turning it off — Settings → General → Privacy → Share anonymous usage statistics. Collection stops immediately and anything queued but unsent is discarded. Full detail in the privacy policy.

Faster underneath, and a handful of fixes worth mentioning.
FIX

Faster everywhere — PDF pages now stream instead of loading whole. Scanning itself moved off the main thread so the app stays responsive while it works.

FIX

Renaming, collections, and notes — renames apply correctly, collections survive a reindex, and notes keep their identity across edits instead of occasionally detaching.

FIX

Refile and licensing hardening — drag-to-refile is more reliable, and the license and certificate-revocation checks behind updates were hardened.

2.3.0 August 2026
Straight scans, full-length scans.
FIX

Crooked scans are finally straight — the deskew engine was rebuilt end to end. It had been measuring skew in a distorted coordinate space, over-rotating portrait pages by ~29% and nudging near-straight pages visibly crooked. Angles are now measured correctly, badly skewed pages (up to 30°) get corrected instead of skipped, rotation never clips ink at the page edge, and the page is cropped back to the paper afterward. Validated against a corpus of real scanner output.

NEW

Long paper support — Long paper (receipts, legal) in Settings → Scanner asks the scanner for its longest page instead of stopping at letter length. The scanner detects the end of the sheet; if it can't, ShabuBox safely falls back to normal length. Long pages also pass through image cleanup without being cropped, rotated sideways, or dropped as blank.

FIX

Whitened edge bands removed — pages from white-backed sheet feeders no longer keep a strip of scanner backing on the edge, even when the backing is nearly the same color as the paper.

NEW

Reprocess with feedback — Reprocess scan now remembers how a page was originally scanned and treats it the same way, and every view shows a live “Processing…” indicator while it runs.

Curate your library — favorites, notes, fields, and typed tables.
NEW

Favorites, notes, and custom fields — star documents, attach free-form notes, and define your own typed fields, including a currency type with proper money formatting.

NEW

Typed tables — documents of the same type (statements, receipts, invoices…) can be viewed as a sortable table of their fields, with column sorting.

NEW

Inspector redesign — a cleaner document inspector, unified collections, and faster search.

Identity you can trust.
FIX

Trustworthy file identity — the content-hash identity behind deduplication and thumbnails was hardened end to end: thumbnails can no longer show the wrong document’s content, rescans update atomically, and a save race can no longer lose a thumbnail.

2.2.1 July 2026
Scan filter fixes — no more black pages, no more darkened scans.
FIX

Solid-black scans with Auto-levels — pages with dense black text or off-white paper could collapse the contrast stretch and render entirely black. The stretch is now mathematically incapable of failing this way, and mid-tones come out more faithful everywhere.

FIX

Background cleanup darkened pages — the whitening filter had its color adjustment inverted, darkening every page it touched instead of lifting the paper color to white. Gray and tinted paper now cleans up to a proper white background with text left dark.

2.2.0 July 2026
Sharper entities — confidence-gated, noise-filtered, reprocessable.
NEW

Confidence gating — GLiNER extractions now carry confidence scores, and low-confidence guesses are skipped instead of cluttering your entity list.

NEW

Reprocess Entities in Settings → Maintenance re-runs extraction on every document in the library, so accuracy improvements apply retroactively.

FIX

Noise filter round two catches kinship terms, document roles, and structure labels that slipped through the first pass. Concurrent reprocess and typing passes no longer collide.

Better scans, clearer errors.
NEW

Scan image processing pipeline — a multi-step chain cleans up scanned pages before OCR, improving text extraction on noisy or skewed originals.

FIX

Actionable USB error messages — when a scan fails, the alert tells you what went wrong and what to try, instead of a generic error.

Small things that add up.
NEW

Drag to refile — drop files onto sidebar folders to move them where they belong.

FIX

Repair Library now surfaces pruned tombstones in its summary. The postal-address fold self-heals when its bookkeeping outlives the table.

2.1.0 July 2026
A Map that pins every address your documents mention.
NEW

Map section — every address extracted from your documents, geocoded offline from a bundled Census gazetteer. Three-tier collapse by state and city, an evidence-picked filter to narrow by person, and tap any pin to jump to the source document.

NEW

Addresses as a fourth entity kind alongside people, organizations, and places — browsable from the Entities sidebar with the same list-and-detail pattern.

NEW

Address normalizer — standardizes and deterministically groups address variants so "123 Main St" and "123 Main Street, Apt 2" cluster together.

Dark mode, done right.
NEW

Light, Dark, or Follow the Mac — choose in Settings. Every design token adapts, from accents through elevated surfaces, backed by an appearance-parameterized snapshot harness.

Collections — summaries, notes, and a better timeline.
NEW

On-device document summaries — per-collection, with LLM summaries and larger thumbnails. Sensitive documents route through the local model; clean ones use Apple Intelligence.

NEW

Notes section with inline add, and a Timeline toggle between added date and document date.

FIX

Summaries now persist across navigation instead of re-summarizing from zero.

Trash and Duplicates — a real file lifecycle.
NEW

Trash and Duplicates sections in the sidebar, with bulk Restore and Delete Permanently.

FIX

Re-adding a deleted file restores it. Interrupted deletes finish. Tombstones can't be filed out of the trash. Restored files are fully re-indexed.

In-app feedback, smarter chat, and reliability.
NEW

Help → Report an Issue — in-app issue filing via GitTickets, with a privacy-aware relay. My Reports lets you check on them without leaving the app.

NEW

"Most capable local model" ceiling — opt into a larger chat model, gated by available RAM, with explicit consent before any large download.

FIX

Scanning, ingestion, and entity extraction are more resilient: timeboxed OCR, real download timeouts, and a stalled inbox row never locks the user out.

NOTE

Menu bar icons, persistent page rotation, entity suppress/hide, move/refile from Folder Health, and app icon v3.

2.0.2 July 2026
App Sandbox, in-process scanning, and a new icon.
NEW

App Sandbox — Release builds now run sandboxed with iCloud entitlements and a full privacy manifest. A one-time migration moves the library into the container.

NEW

In-process SANE scanning — the ScanSnap iX1300 now scans inside the sandbox without ScanSnap Home. eSCL/AirScan declares Bonjour correctly.

NEW

App icon v3 — refreshed design.

FIX

Vision OCR is timeboxed so a wedged ML stack can't stall the pipeline. GLiNER downloads stay out of the GPU gate. A stalled "Processing..." row never locks the user out.

FIX

Scanned-document naming settles after extraction; the Cancel button no longer sticks.

2.0.1 July 2026
Licensing fix and website launch.
FIX

Licensing uses the data-protection keychain — no more password prompt on launch.

NOTE

Paddle checkout live on shabubox.com; download page flipped to the ready card.

2.0.0 July 2026
A ground-up rebuild — it reads your paperwork and files it for you.
NEW

Ask your documents. Put a question to a collection in plain language and get an answer with numbered citations back to the exact page. Apple Intelligence answers on-device; a local model or direct passages cover anything it declines — so it never dead-ends, and your documents and questions never leave your Mac.

NEW

Files itself, and knows when not to. File a few documents and ShabuBox learns your folders — auto-filing when it's confident, suggesting when it's close, abstaining when it isn't sure.

NEW

People, organizations, and places from every document become a browsable, cross-linked index.

Scan straight in, and find anything.
NEW

Scan drives the Fujitsu ScanSnap iX1300 over USB, works with any eSCL/AirScan network scanner, or watches a folder — PDF or JPEG, duplex, colour or mono.

NEW

⌘K search across every OCR'd word, note, entity, collection, and reminder. Optional on-device semantic search finds documents by meaning too.

More than a file pile.
NEW

Markdown notes with wiki-links, a calendar built from the dates inside your documents, smart collections that keep themselves current, reminders that sync with the macOS Reminders app, and a Folder Health view that shows what needs attention.

Yours, always — and how it's sold now.
NOTE

Documents stay ordinary files in ordinary folders; the database is just a rebuildable index. Optional iCloud Drive sync keeps a library in step across your own Macs. Everything runs on your Mac — no account, and your documents stay put.

NOTE

Free for 30 days with every feature unlocked, then a one-time $24.99 — no subscription, nothing renews. ShabuBox now updates itself in place through Sparkle, each update signed and verified.

NOTE

Requires macOS 26 or later on an Apple Silicon Mac.