Skip to content
Back

Voice recorder

Record a voice message in the composer: permission, live level bars, a timer that counts down near the limit, pause, then play, discard or send.

oxyn add voice-recorder
MCP
Hold a thought? Record up to 2:00.
Dioxus
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        max_s: 120,
        on_send: move |ms: u64| upload(ms),
    }
}

Rendered from Rust at build time · goes live when visible

When to use

  • The user wants to talk instead of type: dictate a long prompt, think out loud, or answer an agent's question with their hands busy.
  • Two different intents share the composer and must look different (research note 04 found most chat apps ship them side by side: a mic for dictation and a waveform button for live voice):

When not to use

  • Send, stop, queue and steer in one control, in twelve styles: use Send control instead.
  • Messages typed while the agent works wait above the composer: use Queue stack instead.
  • Prompt composer with model picker, voice input, app connections and approval request: use Chat Composer instead.

Installation

Voice recorder is free and MIT. The oxyn CLI copies its code, and the components it needs, into src/oxyn/ of your Dioxus or GPUI project, so it is yours to change.

Terminal
cargo install --git https://github.com/ismailqureshi72/Oxyn oxyn-cli
oxyn init
oxyn add voice-recorder
Rust
use crate::oxyn::{VoiceRecorder, COMPOSER_CSS};

Rather depend on the crate? cargo add oxyn-dioxus oxyn-core --git https://github.com/ismailqureshi72/Oxyn, then use oxyn_dioxus::{VoiceRecorder, COMPOSER_CSS};

Usage

Dioxus · rust
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        max_s: 120,
        on_send: move |ms: u64| upload(ms),
    }
}

Examples

Idle

A mic in the composer row.

Hold a thought? Record up to 2:00.
Code
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        max_s: 120,
        on_send: move |ms: u64| upload(ms),
    }
}

Recording

Live level bars, timer and pause.

0:04
Code
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        max_s: 120,
        on_send: move |ms: u64| upload(ms),
    }
}

Review

Play, discard or send.

0:18
Code
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        max_s: 120,
        on_send: move |ms: u64| upload(ms),
    }
}

Card

Card variant near its limit.

0:04
Code
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        variant: "card",
        max_s: 15,
        on_send: move |ms: u64| upload(ms),
    }
}

Denied

The microphone was refused.

Hold a thought? Record up to 2:00.
Code
rsx! {
    VoiceRecorder {
        now_ms: clock.now(),
        max_s: 120,
        on_send: move |ms: u64| upload(ms),
    }
}

API reference

VoiceRecorder

PropTypeDefaultDescription
now_msrequiredu64—Host clock (ms).
max_su64120Limit in seconds.
phaseString"idle"Starting phase (`idle` · `recording` · `paused` · `review` · `denied`), for demos.
denyboolDefault::default()The permission prompt answers no.
barsusize28Bars in the meter.
variantString"inline"Variant: `inline` (inside a composer row) or `card`.
on_sendEventHandler<u64>—A recording was sent (its length in ms).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EnterorSpaceStart, pause, resume, stop or send
TabPause, stop, discard, send

Accessibility

  • Every button names its action; the bars are aria-hidden.
  • A polite region announces start, pause, the last ten seconds and send.
From the spec
  • Labels per state: Idle "Start dictation"; Recording "Stop dictation and insert text" (✓) and "Cancel dictation" (✕); PTT "Hold to dictate"; Denied "Microphone blocked. Activate to see how to allow it"; Disabled "Dictation unavailable: <reason>"; voice-mode "Start voice conversation".
  • Live region (polite): "Listening", "Didn't catch anything", "Transcribing", "Inserted 24 words", "Dictation cancelled", "Language: Spanish". Assertive only for permission denied and device errors. Partial transcript text is not announced word by word (it would talk over the user); the final text is readable in the input after confirm.
  • Recording indicator has a text equivalent ("Recording, 0:07") exposed on the strip, and the aria-pressed/toggled state on the mic.
  • Contrast: waveform bars ≥ 3:1 against the strip background; partial words at 60 % opacity must still meet 4.5:1 (darken the base ink token if needed); danger and warning tones carry an icon, never colour alone.
  • Focus order: mic → (strip appears) language chip → ✕ → ✓. Focus moves to ✓ on start only for pointer starts; keyboard starts keep focus in the input so Enter/Esc work. On end, focus returns to where dictation began.
  • Reduced motion: see timing table; level bar always present.
  • Screen-reader users and dictation often already use OS dictation; the component must not steal OS dictation hotkeys.

Motion & interaction

  • Mic hover / press. Hover tints the 32 px hit area (icon 18 px). Press scales the glyph 0.94. A press longer than 200 ms (hold_threshold, proposed) is push-to-talk; shorter is a toggle.
  • Composer → strip morph. The input text crossfades out while the strip fades and scales in from the mic's x-position (transform-origin at the mic). The send ↑ morphs to ✓ in the same frame, reusing the send control's glyph morph. Draft text that existed before dictation is kept: the transcript is inserted at the caret on confirm, never replacing the draft.
  • Waveform. Bars 2 px wide, 2 px gap, 2–24 px tall, rounded caps. New bars append at the playhead (a 1 px accent line at the write head). When the strip is full, history scrolls left at a constant rate so the playhead stays at 85 % of the strip width. Bar height = smoothed RMS level mapped from −60…0 dBFS (attack 30 ms, release 150 ms, proposed).
  • Level / noise meter. The breathing dot doubles as a level meter (scale 1.0–1.35 with level). Two hints, each shown once per session (proposed thresholds): Too quiet — speech-band level stays under −45 dBFS for 3 s while Capturing; Noisy room — noise floor above −35 dBFS for 2 s in Listening. Clipping (> −1 dBFS) paints the top 2 px of the bar in warning tone.
  • Live transcript. Region above the strip, 14 px text, 1–3 lines visible (grows upward, then scrolls with a top fade mask 16 px). Partial words blur-in (4 px → 0) at 60 % opacity; when the recogniser finalises them they settle to 100 % without moving. Words never reflow backwards once final; partials may be replaced in place.
  • Timer. 0:07 at the strip's leading edge, tabular figures; at 4:30 of a 5:00 cap it turns warning tone and shows "30 s left"; at the cap it auto-confirms (goes to Finalizing).
  • Confirm. Final transcript translates down into the input baseline and becomes ordinary draft text; the strip collapses; ✓ morphs back to ↑ (or to the busy-state control). Optional Cuelume-style success tick sound [R110] (off by default).
  • Cancel. Strip shrinks back into the mic; transcript fades; no shake (cancel is not an error).
  • No-input. Waveform dims, hint slides up 8 px. The mic stays open for 2 s more in case speech starts (then closes), so "Try again" rarely needs a second permission round-trip.
  • Language switch. A 2-letter chip (EN) at the strip's trailing edge opens the language menu (recent 3 on top, then Auto-detect, then all). Switching mid-capture closes the current segment and opens a new one; text so far stays. RTL languages flip the transcript region's direction per segment.
  • Permission denied. Mic does one 2-cycle 4 px shake, then shows the slash. "How to allow" opens platform-specific steps (browser site settings vs. macOS Privacy & Security, proposed copy).
  • Voice-mode entry. Waveform-bars button beside the mic. Press → the whole composer row morphs into the voice-session bar (height grows by 8 px max, upward). Exit returns the draft untouched.
Timing

Easing names refer to the composer motion tokens in composer.md.

TransitionDurationEasing / springNotes
Mic hover tint100 msease.out
Mic press scale 1 → 0.94 → 180 ms down, 140 ms upease.out / spring.snap
Tap vs hold decision200 ms—hold_threshold, proposed
Input fade-out → strip in120 ms out, 180 ms in, 40 ms overlapease.outstrip scales 0.96 → 1 from mic origin
↑ → ✓ glyph morph160 msspring.snap (critically damped)same as send control
"Starting mic…" text appearsdelay 300 ms, fade 120 msease.outonly if Arming is slow
Waveform frame rate30 fps (60 fps in expressive)—shared motion clock
Level smoothingattack 30 ms, release 150 msexponentialproposed
Breathing dot (Listening)1600 ms loopsinescales with level while Capturing
Partial word blur-in140 ms, 30 ms stagger (cap 6 words)ease.outblur 4 → 0 px, opacity 0 → 0.6
Partial → final settle120 msease.outopacity 0.6 → 1, no movement
No-input timeout8 s silence in Listening—proposed; mic closes 2 s after hint
No-input hint slide160 msease.outy +8 → 0
Max dictation / warning5:00 cap, warn at 4:30—proposed, app-configurable
Finalizing timeout15 s—then TranscriptionError
Confirm: transcript → input200 msease.in-outstrip collapse 160 ms, starts at 80 ms
Cancel: strip → mic140 msease.intranscript fade 100 ms
Permission-denied shake240 ms, 2 cycles, 4 pxlinear
Language chip flash1 frame accent + 200 ms fadeease.out
Voice-mode morph240 msspring.softowned jointly with voice-session
Reduced motionall morphs become 80 ms opacity crossfades; waveform replaced by a single horizontal level bar updated at 10 fps (level is information, so it stays); no blur-in, no shake (slash + text only); breathing dot static——

Responsive behaviour

  • The inline variant fits a 320 px composer row.
Edge cases (spec)
  • Long dictation. Transcript region caps at 3 visible lines then scrolls; on confirm the draft may exceed the input's max rows, so the input-shell's own overflow applies. 5-min cap prevents runaway.
  • Existing draft. Insert at caret with a single leading space if the char before the caret isn't whitespace; never overwrite a selection silently (selection is replaced only when the user started dictation with text selected — proposed "dictate to replace").
  • Agent busy. Dictation works during Thinking/Streaming/ToolRunning. Confirm inserts into the draft; the send control is then in WorkingWithDraft and its busy_action applies. With InsertAndSend, the text goes to the queue as a normal queued message.
  • Awaiting approval / question card. Confirmed text answers the open card (send control Answering). Saying "approve" is not treated as approval (proposed: no voice commands for consequential actions in v1).
  • Voice mode while agent speaks. Mic is Disabled("Agent is speaking — tap to interrupt") unless the session supports barge-in; then the interrupt belongs to voice-session.
  • RTL / mixed scripts. Strip layout mirrors (timer trailing, chip leading). Transcript direction is per segment; bidi isolation around each segment.
  • Tiny sizes. At 16–20 px the mic is glyph-only; the strip needs ≥ 160 px width, below that the variant falls back to voice-input/pill. In a 28 px IDE row the waveform drops to 1 px bars, max 14 px tall.
  • Touch. 44 × 44 px minimum hit area. PTT on touch: hold ≥ 200 ms; slide up 48 px or off-target to cancel; haptic tick on start and on cancel (mobile, proposed).
  • Slow network (server STT). Partials may lag: show the waveform immediately and keep a "Transcribing…" shimmer at the tail; never block capture on the network. Offline with server-only STT → Disabled("Offline — dictation needs a connection"); on-device STT keeps working.
  • Very fast recogniser / very short utterance. Under 400 ms of speech with no text → treat as NoInput, not error.
  • Device changes. Unplugging the active mic mid-capture → DeviceError, transcript so far kept as draft. A new default device is not auto-adopted mid-capture (avoids recording the wrong room).
  • Window loses focus. Capture continues (it's a dictation, not a hover); the notch Pro variant or OS mic indicator is the reminder. Toggle mode keeps recording; PTT with a key ends on key-up even if focus moved (proposed).
  • Hotkey collisions. Every global candidate collides with some OS or IME shortcut (e.g. input switching), so Oxyn ships no global PTT default; apps set one. The in-composer hotkey is configurable and shown in the mic tooltip.

Notes for AI

  • Import VoiceRecorder from oxyn_dioxus and include COMPOSER_CSS plus the token stylesheet once.
  • A GPUI version exists: VoiceRecorderEl in oxyn_gpui.
  • Props to set first: now_ms.
  • It reads a clock (now) for live timers; pass one clock for the whole page rather than one per component.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI