Skip to content

Releases

MelonBerry 1.1

MelonBerry 1.1 Latest
Latest

Choose a tag to compare

View all tags
@joshkerr joshkerr released this 28 Oct 18:58
v1.1
50e1b4e

Faster multi-page batches and optional document-based file names.

What's new

  • Shorter pauses between sheets (#1). The SANE fujitsu driver holds each page until it is cropped and written out before feeding the next sheet, so host-side work showed up as a pause between pages. Scans are now written as uncompressed TIFF instead of PNG (PNG encoding cost about half a second per side), and the scanner is asked to read ahead into its own memory (--buffermode=On) and stage the next sheet (--prepick=On) — options the driver otherwise leaves off. Both are passed only when scanimage -A reports them as active for your scanner. defaults write com.joshkerr.MelonBerry fastFeed -bool NO turns them off if a scanner misbehaves.
  • Name files from the document (#2). A new setting, Name files by: What's on the first page, names the PDF <date> <title> <kind> — for example 2026-02-19 Acme Energy Statement.pdf. The date is the first one on the page that isn't a due or expiry date (the scan date if there is none), the title is the largest text in the top half of the page, and the kind is a word like Invoice, Receipt or Statement if one appears. Recognition runs on your Mac with Apple's Vision framework; nothing is sent anywhere. Pages with no usable text keep the Scan <date> <time> name. Off by default.
  • The scan command-line script gets the same feeder options and TIFF change.

Install

Requires macOS 14 or later and Homebrew:

brew install sane-backends ocrmypdf img2pdf

From source (recommended):

git clone https://github.com/joshkerr/melonberry.git
cd melonberry
./build.sh --install

Prebuilt app: download MelonBerry-1.1.zip below, unzip, and move MelonBerry.app to /Applications. It's Apple Silicon only and ad-hoc signed (not notarized), so macOS will block the first launch. Either allow it under System Settings → Privacy & Security → Open Anyway, or clear the quarantine flag:

xattr -dr com.apple.quarantine /Applications/MelonBerry.app

Quit the vendor's scanning software first — only one program can hold the scanner's USB connection. See the README for details and limitations.

Assets 3
Loading

MelonBerry 1.0

MelonBerry 1.0

Choose a tag to compare

View all tags
@joshkerr joshkerr released this 19 Sep 23:11
v1.0
45e6df7

First release of MelonBerry — a tiny macOS menu bar app for sheet-fed document scanners. Drop paper in the feeder and a searchable PDF appears in your folder.

Highlights

  • Scans when you load paper — watches the feeder's paper sensor and scans the whole stack, both sides, three seconds after you drop it in.
  • Live page preview in a floating window that never steals keyboard focus and closes itself when the PDF is saved.
  • Automatic cleanup — skips blank sides, fixes upside-down pages, straightens skew, and snaps near-Letter/A4/Legal pages to an exact size.
  • OCR on everything via OCRmyPDF, with an image-only PDF as the fallback if OCR fails.
  • Command-line equivalents (scan, scan-watch) using the same pipeline.

Built for and tested with a ScanSnap iX1600 over USB using the open-source SANE fujitsu backend.

Install

Requires macOS 14 or later and Homebrew:

brew install sane-backends ocrmypdf img2pdf

From source (recommended):

git clone https://github.com/joshkerr/melonberry.git
cd melonberry
./build.sh --install

Prebuilt app: download MelonBerry-1.0.zip below, unzip, and move MelonBerry.app to /Applications. It's Apple Silicon only and ad-hoc signed (not notarized), so macOS will block the first launch. Either allow it under System Settings → Privacy & Security → Open Anyway, or clear the quarantine flag:

xattr -dr com.apple.quarantine /Applications/MelonBerry.app

Quit the vendor's scanning software first — only one program can hold the scanner's USB connection. See the README for details and limitations.

Loading