| Channel | Price | Notes |
|---|---|---|
| GitHub Releases | Free | APK attached to every vX.Y.Z tag |
| IzzyOnDroid | — | Not available; request closed |
| Google Play | Paid | Same app, convenience pricing — auto-updates and supports development (listing in preparation) |
The GitHub APK is available now; the planned Play listing has the same features. The Play build is signed by Play App Signing, so a Play install and a GitHub install can't upgrade each other — pick one channel per device. Privacy policy: PRIVACY.md.
ANDROID MOBILE (Expo + RN) WORKSTATION
┌───────────────────────────────┐ ┌──────────────────────────┐
│ Capture screens │ │ │
│ ├ Idea (text) │ │ ~/Obsidian/Carnet/ │
│ ├ Journal (voice→text) │ HTTPS │ Ideas/{slug}.md │
│ ├ Person (camera→OCR) │ ───────► │ Journal/YYYY-MM-DD.md│
│ └ Photo (camera→vision) │ │ People/F-L.md │
│ │ │ │ Photos/{slug}.jpg │
│ ▼ │ │ ▲ │
│ lib/omniroute.ts (LLM) │ │ │ │
│ lib/prompts.ts │ │ Syncthing daemon │
│ lib/writer.ts (md to disk) │ │ ▲ │
│ lib/queue.ts (offline) │ │ │ │
│ │ │ │ │ │
│ ▼ │ │ │ │
│ Local folder ────────────────┼──────────┼─► carnet/ folder │
│ /Documents/carnet/ │ Syncthing p2p │
│ │ │ │
│ ▼ │ │
│ Syncthing Android app │ │
└───────────────────────────────┘ └──────────────────────────┘
NO DAEMON. NO CUSTOM RUST. NO HMAC HANDSHAKE.
Six capture modes:
| Mode | Input | Output |
|---|---|---|
idea |
text / dictation | Ideas/{slug}.md (save-first: file lands instantly, enrichment patches after) |
note |
text / dictation | Notes/{slug}.md (save-first; titled and tagged, never expanded — action lines become - [ ] todos) |
journal |
voice transcript (+ text) | Journal/{YYYY-MM-DD}.md (appends to existing) |
person |
business card scan (vision OCR) + dictated context | People/{Firstname-Lastname}.md |
photo |
in-app camera (+ voice/text context) | Photos/{slug}.jpg + paired Ideas/{slug}.md (via OmniRoute vision) |
audio |
voice memo | recording + on-device transcription → journal |
All modes go through OmniRoute for LLM enrichment, then write directly to the local capture folder. Offline captures are queued on-device (AsyncStorage) and drained on reconnect. Photo capture shares the same vision pipeline used by the Android share-target (Share → carnet on an image). Quick captures also work from the persistent notification's inline reply, and the vault is browsable/searchable in-app (tags + full text).
The Todos screen collects Markdown checkboxes across the active vault. Search matches task text or the source note title. Choose Open, Completed, or All; filter by capture mode and source-note tags (any selected mode and any selected tag match, with the filter categories combined). Sort by Newest or Oldest using the source note's date, or by Source. Optional source grouping keeps tasks from each file together, even when notes share a title. View choices are remembered separately for each profile and vault folder. Task completion still updates the checkbox in its original Markdown file.
Any note can optionally be pushed to a self-hosted Karakeep instance from its detail screen ("Send to Karakeep" → text bookmark + tags + image/file attachments). Export is opt-in and configured per device.
carnet/
apps/
mobile/ Expo 54 + React Native + TypeScript
mdcrm/ Optional Markdown contact/event processor + CLI
packages/
shared/ @carnet/shared — note types + markdown helpers
docs/
sync-setup.md Syncthing setup guide (Android + workstation)
- Node 20+
- npm 10+
- For mobile: Expo CLI and a physical Android device or emulator
- An OmniRoute API key (set in the app's Settings screen)
- Syncthing installed on both your Android device and workstation — see docs/sync-setup.md
No daemon, no navetted, no Rust toolchain required for mobile development.
# Install once at root (postinstall applies patches/ via patch-package)
npm ci
# Build the shared package (types + markdown helpers)
npm run build:shared
# Run mobile in Expo
npm run mobile
# Type-check
npm -w @carnet/mobile run typecheck
npm -w @carnet/shared run typecheck
# Build/test the optional server-side Markdown processor
npm run mdcrm:build
npm run mdcrm:testOpen the Settings screen in the app and set:
| Setting | Description |
|---|---|
| OmniRoute URL | Base URL of your OmniRoute instance (e.g. https://llm.grepon.cc) |
| OmniRoute API key | Your API key — stored in the OS secure keystore via expo-secure-store |
| Capture folder | Your Syncthing-watched folder on Android (e.g. /storage/emulated/0/carnet) — choose it with Pick folder, which grants the app access; typing the path doesn't work on current Android. Leave blank to use the app sandbox. |
| Karakeep URL | (Optional) Base URL of a self-hosted Karakeep, for per-note export (e.g. https://keep.example.com) |
| Karakeep API key | (Optional) Karakeep API key (Karakeep UI → User Settings → API Keys) — stored via expo-secure-store |
See docs/sync-setup.md for step-by-step instructions to pair the Android capture folder with ~/Obsidian/Carnet/ on your workstation.
AGPL-3.0-only