Skip to content

Apple Watch

The Mossie Watch app lets you capture voice notes and set reminders from your wrist -- perfect for quick observations during class without reaching for your phone.

Installation

  1. Pair your Apple Watch with your iPhone if you have not already
  2. Open the Watch app on your iPhone
  3. Find Mossie in the list of available apps
  4. Tap Install to add Mossie to your watch

The first time you open the watch app, it shows a pairing screen. Sign into Mossie on your iPhone and the watch app will receive your authentication automatically via WatchConnectivity.

Home Screen

When you open Mossie on your watch, you see:

  • Record Note button -- A large orange circle with a mic icon. This is the primary action.
  • Connection status -- If your iPhone is not reachable, an indicator appears
  • Pending captures -- Shows how many notes are waiting to sync
  • Recent captures -- A scrollable list of your last few voice notes, each showing the transcription text, a relative timestamp, and a sync status icon (pending or synced)

Recording a Note

  1. Tap the Record button -- Recording starts automatically
  2. Speak your observation -- for example, "Emma helped Jake with the math problem today"
  3. Tap Stop when finished -- A waveform visualization shows during recording with a live timer
  4. Wait for transcription -- The audio is sent to your iPhone (or directly to the backend) for transcription
  5. Confirm entities -- If Mossie detects student names, a confirmation screen appears showing each detected student with their matched roster name and confidence level
  6. Save -- The note is created and linked to the confirmed students

Entity Confirmation

When Mossie detects student names in your recording, the confirmation screen shows:

  • Each matched student with an avatar, their resolved full name, and what you originally said
  • Confidence indicator -- A warning icon appears next to low-confidence matches (below 80%)
  • Primary student -- The main student the note is about, marked with a "Primary" badge
  • Confirm button -- Save the note linked to these students
  • "Save without linking" option -- Save the note without student associations

If no students are detected, or all matches are high-confidence, the note is saved immediately without the confirmation step.

Offline Support

The watch app works even when your iPhone is not nearby:

  • Recording works offline -- Audio is recorded and stored locally on the watch
  • Automatic sync -- When your phone comes back in range, pending captures are synced automatically
  • Pending indicator -- The home screen shows how many captures are waiting
  • Up to 50 captures stored -- The watch keeps the last 50 captures in local storage

Standalone Mode

When your iPhone is not reachable, the watch can operate independently:

  • Direct WiFi or cellular -- If the watch has network access (WiFi or cellular Apple Watch), it transcribes audio by calling the Mossie backend API directly
  • Authentication -- The watch stores an auth token in the Keychain for direct API access
  • Fallback to queue -- If neither the phone nor the network is available, the capture is queued locally for later sync
graph TD
    A[Record Audio] --> B{iPhone Reachable?}
    B -->|Yes| C[Send to iPhone]
    C --> D[iPhone transcribes via backend]
    D --> E[Return result to watch]
    B -->|No| F{WiFi / Cellular?}
    F -->|Yes| G[Transcribe directly via API]
    G --> E
    F -->|No| H[Queue for later sync]
    H --> I[Sync when phone returns]

How Sync Works

When the watch detects that the iPhone has become reachable again, it automatically sends all pending captures. You do not need to open the app on both devices -- the sync happens in the background via WatchConnectivity.

Tips for Watch Users

  1. Speak clearly -- The watch microphone is small; enunciate student names carefully for better matching
  2. Keep it brief -- Short observations (10 to 30 seconds) transcribe most reliably
  3. Use student names -- Say names clearly so Mossie can match them against your roster
  4. Check pending count -- If you see pending captures, bring your phone nearby to sync
  5. Relaunch after signing in -- If you sign into Mossie on your iPhone after installing the watch app, reopen the watch app to pick up the authentication

Troubleshooting

Watch app shows "Pair with iPhone"

This means the watch has not received authentication from your iPhone:

  1. Open Mossie on your iPhone and make sure you are signed in
  2. The iPhone app sends auth status to the watch automatically
  3. If it still does not work, try force-quitting and reopening the watch app

Notes not syncing

  1. Ensure your iPhone is nearby and has Bluetooth enabled
  2. Make sure Mossie is installed on your iPhone (it does not need to be in the foreground)
  3. Open the watch app to trigger a manual sync attempt
  4. If using a cellular Apple Watch, check that it has network access for standalone mode

Poor transcription quality

  1. Reduce background noise when recording
  2. Speak closer to the watch microphone
  3. Keep recordings under 60 seconds for best results
  4. If transcription consistently fails, check your internet connection on the iPhone