Skip to content

Readpaw 0.1.0

Choose a tag to compare

View all tags
@moerdowo moerdowo released this 13 May 10:07
· 29 commits to main since this release
v0.1.0
07c0d89

First public release.

Install

  1. Download Readpaw-0.1.0.dmg below.

  2. Before double-clicking it, run this in Terminal:

    xattr -dr com.apple.quarantine ~/Downloads/Readpaw-0.1.0.dmg

  3. Now double-click the DMG and drag Readpaw onto Applications.

    If you skip step 2, macOS Sequoia will block the DMG with "Apple could not verify 'Readpaw-0.1.0.dmg' is free of malware…" and won't offer an Open Anyway button in the dialog — you'd have to walk through System Settings → Privacy & Security instead (see below).

  4. After the app is in /Applications, also clear the quarantine flag from the app once:

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

  5. Launch Readpaw normally from Spotlight / Dock.

Why? — ad-hoc signed, not Apple-notarised

The DMG is signed locally but not run through Apple's notary service (that requires a paid Apple Developer ID). macOS attaches a com.apple.quarantine extended attribute to anything downloaded from a browser, and Sequoia's Gatekeeper refuses to open quarantined items that aren't notarised. The xattr -dr com.apple.quarantine … command removes that attribute and the OS stops blocking.

Alternative — System Settings flow

If you'd rather not touch Terminal:

  1. Double-click the DMG. macOS will refuse and show the "Apple could not verify…" dialog. Click "Done", don't move it to the Bin.
  2. Open System Settings → Privacy & Security.
  3. Scroll to the security section near the bottom. You'll see a line about Readpaw-0.1.0.dmg being blocked. Click Open Anyway next to it.
  4. macOS will prompt for your password / Touch ID, then mount the DMG.
  5. Drag Readpaw onto Applications, then repeat the same Privacy & Security flow the first time you try to launch the app.

Alternative — build from source

If you'd rather skip all of this, clone the repo and build locally. Local builds aren't quarantined:

git clone https://github.com/moerdowo/Readpaw.git
cd Readpaw
./scripts/build-app.sh
open build/Readpaw.app

Highlights of 0.1.0

  • Native macOS reader for EPUB, MOBI / AZW / AZW3, PDF, CBR, CBZ, plus 7z / ZIP / RAR image archives, FB2, TXT, HTML
  • Library with cover thumbnails, search, sort, and resizable cards
  • Reader window opens at the page's aspect ratio; per-book zoom / direction / text-size persistence
  • Image reader (NSScrollView) with pinch-to-zoom remembered per book
  • Vertical / webtoon mode with smooth real-visibility page tracking
  • Ebook reader (WKWebView) with full text-color override, comfortable reading margins, and a dark/light toggle that wins over publisher styles
  • Right-to-left support: slider, fill direction, and endpoint labels all flip together
  • Unreadable files are silently skipped during library scan (no broken cards)
  • Onboarding with an interactive rotating USDZ 3D model (CC BY Tamminen)

System requirements

  • macOS 15.0 (Sequoia) or later
  • Apple Silicon (arm64)
Assets 3
Loading