Skip to Content
ScribeKey Docs

How the bubble and Typing access work

Why ScribeKey is a bubble beside your keyboard and not a keyboard, what Typing access lets it do, and when the bubble shows or hides.

ScribeKey is not a keyboard. You keep the keyboard you already use, and ScribeKey adds the dictation bubble, a small control with the ScribeKey mark that appears beside your keyboard when you type in any app. Tap the bubble, speak, and ScribeKey types your words into the field. This page explains what the bubble needs from Android and when it shows.

Two Android permissions

The bubble needs two permissions besides the microphone:

  • Display over apps lets the bubble show on top of the app you are typing in.
  • Typing access lets ScribeKey see which text field is active and type into it. Android calls this an accessibility service, and lists ScribeKey on its Accessibility page.

Without them you can still record in Capture, inside ScribeKey, with the microphone alone. Permissions lists each one and its state.

What Typing access reads

Android grants an accessibility service wide access to the screen. ScribeKey uses it for these jobs only:

  • It checks whether a text field is active and whether the keyboard is open, to decide when to show the bubble.
  • It reads the cursor position and the selected text, so your words go in at the cursor or replace the selection.
  • It checks whether the field is a password field, and refuses to type into one.
  • It notes the name of the app, which is stored with the session.

It does not store or send the text already in the field. When Learn from my edits is on, ScribeKey follows that one field for up to two minutes after it types. It keeps only the words you changed, with a few words around them, as a Suggestion in your Dictionary. What leaves your phone covers the rest.

When the bubble shows

The bubble shows when all of these are true:

  • Show the bubble is on.
  • Display over apps and Typing access are granted, and Typing access is running.
  • The screen is on and unlocked.
  • A text field is active and the keyboard is open.
  • The bubble is not snoozed, and the app is not in Hide in these apps.

When the keyboard closes, the bubble goes too. A dictation that has already started finishes even if the bubble would hide.

You can snooze the bubble for a while by dragging it to Drag here to snooze. Snooze length sets how long. A notification shows the time left and has End snooze.

How text reaches the field

When you finish speaking, ScribeKey cleans up the words and types them at the cursor. Then it reads the field again to check the words arrived. If it cannot type them, or the field changed while you spoke, it copies the words and shows a message such as Couldn’t insert. Text copied, paste it. Every dictation is also saved as a session, so a failed insert never loses your words.

Android’s shortcut switches the bubble off

Android can add a ScribeKey shortcut to its accessibility settings, which puts a second floating icon on screen. Pressing that icon switches Typing access off, and the bubble with it. Leave the shortcut off. If it is on, ScribeKey shows ScribeKey shortcut is on at the top of Settings.

Pitfall

Without the battery permission, Android may stop the bubble to save battery. Grant Battery on Permissions if the bubble keeps disappearing.