Skip to content

Recording Modes

BiBi Keyboard provides two microphone trigger modes, plus optional auto-stop behavior for different workflows.

Overview

ModeHow to triggerBest for
Press and holdhold the mic button to record; release to stopclassic IME feel; precise control
Tap to toggletap the mic button to start/stoplong dictation; hands-free

Press and hold (default)

How to use

  1. Start: press and hold the mic button
  2. Continue: keep holding
  3. Stop: release finger

Setting

  • Key: micTapToggleEnabled = false (default)
  • Path: Settings → ASR Settings → Tap mic to start/stop (off)

Pros / cons

Pros

  • ✅ intuitive; matches most keyboards
  • ✅ precise control of duration
  • ✅ quick stop on release

Cons

  • ⚠️ finger fatigue for long recordings
  • ⚠️ you must keep holding, hard to do other actions

Gestures

  • Swipe left: cancel recording
  • Swipe right: send/commit recognition immediately
  • Swipe down: temporarily lock recording (press-and-hold mode only)

Tap to toggle

How to use

  1. Start: tap the mic button
  2. Continue: hands-free recording
  3. Stop: tap the mic button again

Setting

  • Key: micTapToggleEnabled = true
  • Path: Settings → ASR Settings → Tap mic to start/stop (on)

Pros / cons

Pros

  • ✅ hands-free, good for long recording
  • ✅ you can read/scroll while recording
  • ✅ no finger pressure
  • ✅ good for long dictation

Cons

  • ⚠️ easy to forget to stop
  • ⚠️ slightly higher accidental trigger risk

Gestures

  • Swipe left: cancel recording
  • Swipe right: send/commit recognition immediately
  • long dictation (articles, reports)
  • meeting notes
  • record while doing other actions
  • combine with VAD auto-stop

Auto-stop Behavior

Under Settings → ASR Settings → Recording auto-stop, choose when recording should end automatically:

ModeDescriptionBest for
Manual stoprelease the mic or tap it again to stopprecise manual control
Stop on silencestop after you stop speaking for a whiledaily input, short messages, chat
Timeout stopstop when "Maximum recording duration" is reachedavoiding forgotten tap-to-toggle recordings

"Timeout stop" does not detect speech; it only stops by duration. Use Auto-stop on Silence (VAD) when you want recording to stop based on pauses.

Continuous Recording While Visible

To make mic starts feel faster, enable Settings → Input Settings → Continuous recording while visible. When enabled, BiBi Keyboard records locally while the keyboard or floating ball is visible. Audio before you press the mic is not uploaded; it is used only to reduce startup latency after you trigger recognition.

Note

This keeps the microphone listening locally while the keyboard or floating ball is visible, which may increase battery usage. Keep it off if you are sensitive to privacy or power consumption.

Quick Switch Button

If you often switch between short messages and long dictation, add the "Recording mode switch" action to your keyboard layout:

  1. Open Settings → Input Settings → Custom keyboard layout
  2. Pick an action-row or keyboard button position
  3. Set its action to Recording mode switch
  4. Return to the keyboard and tap it to switch between press-and-hold and tap-to-toggle recording

Works best with VAD

Tap-to-toggle + auto-stop on silence (VAD) gives an experience close to continuous conversation:

Settings → ASR Settings → Tap mic to start/stop: ON
Settings → ASR Settings → Auto-stop on silence (VAD): ON

Released under the Apache 2.0 License.