phonecapture

phonecapture is now the monorepo for the full Phonecapture system: the Jelly Star appliance, the Mac import menubar app, the source-phone stimulus app, and the shared docs that explain how they fit together.

Repo Layout

apps/
  import-menubar/           macOS menubar importer
  kiosk-android/            Jelly Star appliance app
  source-stimulus-android/  source-phone test stimulus app
docs/                       shared architecture and deployment notes

Product Surfaces

• apps/kiosk-android
  • Android kiosk app for the Unihertz Jelly Star capture appliance
  • owns UVC capture, health UI, transfer server, and appliance recovery
• apps/import-menubar
  • macOS menubar app that imports captures from the Jelly over local HTTP
  • current published release: 0.1.6
• apps/source-stimulus-android
  • Android app for the source phone, usually a Pixel 8a
  • test-only tool for deterministic capture validation

Current Direction

The current recommended appliance path is:

• stock Jelly Star
• userspace UVC
• standalone appliance behavior for v1
• Wi-Fi transfer to the Mac menubar app for normal import
• adb kept as a development and recovery path

The most relevant shared docs are:

• docs/android-harness.md
• docs/jelly-star-stock-uvc-architecture.md
• docs/jelly-star-standalone-appliance-v1.md
• docs/jelly-star-standalone-verification.md
• docs/jelly-star-implementation-phases.md
• docs/source-stimulus-app.md

Hardware Notes

We currently use a UGREEN USB-C capture card. On macOS it enumerates as a standard USB video and audio device manufactured by MacroSilicon, which keeps the stack close to class-compliant paths instead of vendor-only tooling.

Initial device notes live in docs/capture-device-spec.md.

Releases

This monorepo supports multiple app-specific releases:

• import menubar releases are app-scoped
• kiosk/appliance releases are app-scoped
• source-stimulus builds are internal and may not always have formal releases

Do not treat the whole repo as one versioned binary. Each deployable app owns its own release cadence and artifacts.