Skip to content

OditBridge v0.2.0

Latest

Choose a tag to compare

@RobiMez RobiMez released this 28 Jul 22:58

First notarized release of OditBridge — a macOS companion app for odit.et that reads bank SMS from ~/Library/Messages/chat.db (iPhone Text Message Forwarding) and ships them to your odit server.

The app is signed with a Developer ID certificate and notarized by Apple, so it opens like any other app — no Gatekeeper workarounds needed anymore.

Install

  1. Download OditBridge-0.2.0.dmg, open it, and drag OditBridge.app into Applications.
  2. Grant Full Disk Access: System Settings → Privacy & Security → Full Disk Access → add OditBridge.app and toggle it on. The app reads a TCC-protected file (~/Library/Messages/chat.db), so this is mandatory.
  3. In the app: open Settings → set API base URL to your odit server (e.g. https://s.odit.et).
  4. Copy your Device ID from Settings, then in the odit web app (signed in) go to Devices → Link a Mac and paste it. Sync auth is tied to this pairing — uploads are rejected until the device is linked.
  5. Staged tab → Load now → review → Sync now.

The in-app Help → Getting Started (⌘?) walks through the same steps with copy buttons.

Changes since 0.1.0

  • Sync works with the new odit API: all requests authenticate with the x-odit-device-id device header (the API's /api/v2/sync routes now require device or session auth).
  • Messages stored only as attributedBody blobs (no plain text) are now decoded and synced.
  • CSV export for synced transactions.
  • Signed with a Developer ID certificate and notarized — first launch just works.

Requirements

  • macOS 14+
  • iPhone with Text Message Forwarding enabled to your Mac
  • SMS stored unencrypted in iCloud (Advanced Data Protection can leave chat.db empty — see README)