# How the bubble and Typing access work (/concepts/bubble-and-typing-access)

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 [#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](/settings/permissions) lists each one and its state.

## What Typing access reads [#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**](/settings/dictionary#dictionary.learn_from_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](/concepts/what-leaves-your-phone) covers the rest.

## When the bubble shows [#when-the-bubble-shows]

The bubble shows when all of these are true:

- [**Show the bubble**](/settings/bubble#bubble.enabled) 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**](/settings/bubble#bubble.hide_in_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**](/settings/bubble#bubble.snooze_length) sets how long. A notification shows the time left and has **End snooze**.

## How text reaches the field [#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 [#androids-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**](/settings/permissions#permissions.battery) on **Permissions** if the bubble keeps disappearing.

## Related pages [#related-pages]

- [Dictation bubble settings](/settings/bubble)
- [The bubble disappeared](/troubleshooting/bubble-disappeared)
- [Typing access turned off](/troubleshooting/typing-access-turned-off)