Skip to content

OditBridge 0.1.0

Choose a tag to compare

View all tags
@RobiMez RobiMez released this 31 May 18:46
v0.1.0
6bd390d

First public release of OditBridge — a macOS companion app for odit.et that reads bank SMS from ~/Library/Messages/chat.db and ships them to your odit server.

Install

  1. Download OditBridge-0.1.0.zip, unzip it, and drag OditBridge.app into /Applications/.
  2. macOS will refuse to open the app the first time — it's signed with a developer certificate but not Apple-notarized, so Gatekeeper marks it as "unverified". To bypass:
    • Finder route: right-click OditBridge in /Applications/ → Open → click Open Anyway on the dialog.
    • Terminal route (faster): 
      xattr -dr com.apple.quarantine /Applications/OditBridge.app
  3. Open the app once so macOS registers the bundle.
  4. Grant Full Disk Access: System Settings → Privacy & Security → Full Disk Access → click + → add OditBridge.app → toggle it on. The app reads from a TCC-protected file (~/Library/Messages/chat.db) so this is mandatory.
  5. In the app: open Settings (gear icon, top-right) → set API base URL to your odit server (e.g. https://s.odit.et).
  6. Copy your Device ID from Settings → Device → Copy, open the odit web app while signed in, go to Devices → Link a Mac, and paste it. This attributes uploads from this Mac to your account.
  7. Click the Help → Getting Started menu (⌘?) inside the app — it walks through the same flow with one-click buttons.

First sync

  • Staged tab → Load now → review the messages the filter kept → Sync now to upload.
  • Synced / Charts / Heatmap tabs auto-refresh from the server after a successful sync.

Verify

shasum -a 256 OditBridge-0.1.0.zip
# f6f7a0df39a6807ed947c2db99f63d540fcdd525a41637ad394f571339913841

Build it yourself

If you'd rather build from source (no Gatekeeper hoop, no Trust In Stranger required), see README.md. The repo signs ad-hoc by default — xcodegen generate && xcodebuild is enough to produce a working bundle for your own machine.

Known limits

  • Apple Silicon only (arm64). Intel users would need a universal build — open an issue if you want one.
  • The bundle uses a developer cert, not a Developer ID. macOS will not recognize this as a "trusted developer" — that's the Gatekeeper dance above.
  • Sync is one-way: Mac → odit server. The Mac never writes back to chat.db.
Assets 3
Loading