Skip to content
ventouxlabsPublic

About

Mobile-first knowledge capture for Obsidian. Capture ideas, voice journals, people (OCR) and photos on Android, enrich them with an LLM via OmniRoute, and write Markdown straight into your vault — synced peer-to-peer with Syncthing. Expo / React Native app with a Tauri desktop companion, in a TypeScript monorepo.

Topics

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

Carnet — mobile-first knowledge capture for Obsidian

Build License: AGPL-3.0

TypeScript Expo React Native Tauri Obsidian

Get Carnet

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.

Architecture

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.

Layout

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)

Prerequisites

  • 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.

Build

# 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:test

Configuration

Open 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

Syncthing sync

See docs/sync-setup.md for step-by-step instructions to pair the Android capture folder with ~/Obsidian/Carnet/ on your workstation.

License

AGPL-3.0-only

About

Mobile-first knowledge capture for Obsidian. Capture ideas, voice journals, people (OCR) and photos on Android, enrich them with an LLM via OmniRoute, and write Markdown straight into your vault — synced peer-to-peer with Syncthing. Expo / React Native app with a Tauri desktop companion, in a TypeScript monorepo.

Topics

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages