Voice commands are an iPad-only feature. Room Mode and voice activation are not available on iPhone.
How it works
ORbit uses a two-stage voice architecture for reliable, low-power wake word detection:| Stage | Technology | Purpose |
|---|---|---|
| Stage 1 | Picovoice Porcupine | Always-on wake word detection — listens for “Orbit” at very low CPU usage |
| Stage 2 | Apple Speech Recognition | Activates only after “Orbit” is detected — captures and processes the command |
All voice processing happens on-device. Audio never leaves the iPad. The only network call is to classify unrecognized phrases via a secure edge function.
Getting started
Enable voice commands
- Open any active case in Room Mode on iPad
- Grant microphone and speech recognition permissions when prompted
- The voice indicator in the header shows the current state:
- Listening — ready for wake word
- Recognizing — capturing your command
- Processing — classifying an unrecognized phrase
Choose a voice
ORbit speaks back confirmations and prompts using text-to-speech. You can choose which voice is used:- Go to Profile → Room Mode → Voice Selection
- Browse available voices grouped by type:
- Siri Voices — Apple’s Siri voices (if downloaded on your device)
- English voices — system voices sorted by quality (Premium → Enhanced → Default)
- Tap any voice to hear a preview and select it
- Use Reset to Default to revert to the system default (Samantha Premium)
Feedback levels
Control how much audio feedback ORbit provides:| Level | Behavior |
|---|---|
| Full Verbal | Chime + spoken confirmation for every action |
| Sounds Only | Chime on success, spoken feedback only for errors and prompts |
| Silent | Visual feedback only — no audio |
Command reference
Say “Orbit” followed by any of these commands:Recording milestones
Record a milestone timestamp by saying the milestone name naturally. ORbit matches your phrase against configured aliases.- Fast path — instant exact match against known aliases (no network needed)
- Slow path — AI classification via Claude for unrecognized phrases (requires network)
Canceling milestones
Clear a recorded milestone timestamp:Undo last action
Undo the most recently voice-recorded milestone. This always requires verbal confirmation to prevent accidental undos:Call next patient
Trigger the “call next patient” workflow:Surgeon left
Mark the surgeon as having left the OR:Cement timer
Start or stop a floating cement timer overlay:Query commands
Ask ORbit about the current case without touching the screen:Out-of-order protection
ORbit validates milestone sequence before recording. If you try to record a milestone out of order, the system requires verbal confirmation:| Scenario | Behavior |
|---|---|
| All prior milestones recorded | Records immediately with confirmation |
| Any prior milestones missing | Holds command pending — announces what’s missing and asks for confirmation |
| Milestone already recorded | Holds command pending — announces existing time and asks to confirm update |
Example: out-of-order command
Confirm and cancel
When ORbit holds a command pending (out of order, already recorded, or undo), you have 15 seconds to respond:| Command | Effect |
|---|---|
| ”Confirm” / “Yes” | Executes the pending command |
| ”Cancel” / “No” | Discards the pending command |
| No response (15s) | Auto-cancels with a timeout notification |
Confirm and cancel phrases don’t require the “Orbit” wake word — they work directly while a command is pending.
Managing voice aliases
Voice command aliases (the phrases ORbit recognizes) are managed in the web app settings, not on the iPad. This keeps the OR workflow clean and gives admins centralized control.How aliases work
Each alias maps a spoken phrase to a milestone and action type:| Phrase | Milestone | Action |
|---|---|---|
| ”patient in” | Patient In | Record |
| ”cancel patient in” | Patient In | Cancel |
| ”undo” | — | Undo last |
| ”next patient” | — | Call next patient |
Auto-learned aliases
When ORbit’s AI classifies a new phrase with high confidence, it automatically saves that phrase as a new alias. Auto-learned aliases:- Are tagged as
auto_learnedin the database - Are facility-scoped (only apply to your facility)
- Strip the “Orbit” wake word before saving (so “Orbit, patient is ready” is stored as “patient is ready”)
- Take effect immediately — the next time you say the same phrase, it matches instantly
Managing aliases in settings
Go to Settings → Voice Commands in the web app to:- View all aliases (manual + auto-learned) for your facility
- Add new custom aliases
- Delete aliases that aren’t useful
- See which aliases were auto-learned vs. manually created
Voice log
Every voice command is logged in the Voice Log panel within Room Mode. The log shows:| Column | Description |
|---|---|
| Time | When the command was spoken |
| Phrase | What was recognized |
| Action | What ORbit did (recorded, pending, cancelled, unrecognized) |
| Path | How it was matched — dictionary (fast) or AI (slow) |
Troubleshooting
ORbit isn't responding to my voice
ORbit isn't responding to my voice
Check that:
- You’re in Room Mode on an iPad
- Microphone permissions are granted (Settings → ORbit → Microphone)
- Speech recognition permissions are granted (Settings → ORbit → Speech Recognition)
- The voice indicator shows “Listening” — if it shows “Unavailable”, check your microphone connection
- You’re saying “Orbit” clearly before your command
Commands are recognized but not recording
Commands are recognized but not recording
The milestone may be out of order. Listen for the confirmation prompt — ORbit will tell you which milestones are missing and ask you to confirm. Say “Confirm” to proceed.
The same phrase keeps being sent to AI instead of matching instantly
The same phrase keeps being sent to AI instead of matching instantly
The phrase may not have been auto-learned. This happens when:
- The AI returned low confidence (below 85%)
- The network was unavailable during classification
- The phrase was too ambiguous to cache
Voice feedback is too loud or too quiet
Voice feedback is too loud or too quiet
ORbit uses the iPad’s system volume for voice feedback. Adjust the volume using the physical volume buttons or Control Center. You can also switch to Sounds Only or Silent feedback mode in Profile → Room Mode.
ORbit is hearing itself speak and triggering commands
ORbit is hearing itself speak and triggering commands
This shouldn’t happen — ORbit pauses command recognition during speech playback. If it does occur, try switching to Sounds Only feedback mode, which reduces spoken output.
I want to use a Siri voice but don't see any in the picker
I want to use a Siri voice but don't see any in the picker
Siri voices must be downloaded on your iPad first. Go to Settings → Accessibility → Spoken Content → Voices → English and download the Siri voices you want. They’ll appear in the ORbit voice picker after download.Note: The newer “Siri Voice 1-5” voices are not available to third-party apps due to Apple restrictions. The classic named Siri voices (Aaron, Nicky, Martha, Arthur) are available.
Can I use voice commands with a Bluetooth microphone?
Can I use voice commands with a Bluetooth microphone?
Yes. ORbit detects external audio inputs and uses them automatically. The voice indicator will show the connected device name when a Bluetooth or wired microphone is active.
Privacy and security
| Concern | How ORbit handles it |
|---|---|
| Audio storage | Audio is never stored or transmitted. All speech processing happens on-device. |
| Wake word detection | Uses Picovoice Porcupine, which runs entirely on-device with no cloud dependency. |
| AI classification | When a phrase isn’t recognized locally, only the text transcription (not audio) is sent to a secure edge function for classification. |
| HIPAA compliance | No patient data is included in AI classification requests. The edge function receives only the transcription text, facility ID, and case ID for milestone matching. |
Next steps
Room management
Learn about the Room Mode interface and case tracking.
Milestone settings
Configure milestone templates and ordering.
Voice command settings
Manage voice aliases in the web app.
Notifications
Configure how ORbit alerts you about case events.