> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Show keystrokes on screen

> Turn on Keystrokes in Effect to show the keys you pressed over your screen recording. Works on Tella Mac and Windows app recordings made with the app's Keystrokes setting on, and on Auto Capture takes.

Turn on **Keystrokes** in the editor's **Effect** sidebar to draw the keys you pressed over your screen recording as you pressed them. It works on screen recordings made with the Tella Mac or Windows app while the app's **Keystrokes** setting is **Shortcuts only** or **All keys**, and on [Auto Capture](https://www.tella.com/docs/help/integrations/auto-capture.md) takes, which record the keys the capture agent pressed.

[https://www.tella.com/video/vid\_cmvw3e2yz000r08jjgysygj9u/embed?b=0\&title=0\&a=1\&loop=0\&t=0\&muted=0\&wt=0](https://www.tella.com/video/vid_cmvw3e2yz000r08jjgysygj9u/embed?b=0\&title=0\&a=1\&loop=0\&t=0\&muted=0\&wt=0)

## Turn on keystrokes

1. Open your video in the Tella editor.
2. Click **Effect** in the sidebar, or press `E`.
3. Scroll past **Cursor** and turn on **Keystrokes**.

Keystrokes is a video-wide setting: the keys show on every clip whose screen recording has keystroke data, and in your shared and exported video.

## Record keystrokes in the Mac app

The Mac app records your key presses only when its **Keystrokes** setting is on. It's **Off** until you choose a mode.

1. In the Tella Mac app, open **… → Settings → Recording**.
2. Under **Screen**, set **Keystrokes** to:
   * **Shortcuts only**: key combinations such as ⌘C, never the text you type. This is the privacy-safe choice.
   * **All keys**: every key you press, including text and passwords.
3. If **Permission needed** appears, click **Allow**, switch **Tella** on under **System Settings → Privacy & Security → Input Monitoring**, then quit and reopen Tella.

You can also pick **Keystrokes** on the **First, permissions.** screen when you first set up the app; that records **All keys**. Pressing **Continue** without picking it leaves Keystrokes **Off**.

## Record keystrokes in the Windows app

The Windows app records your key presses only when its **Keystrokes** setting is on. It's **Off** until you choose a mode, and it needs no Windows permission.

1. In the Tella Windows app, open the settings.
2. Under **Screen recording**, set **Keystrokes** to **Shortcuts only** (shortcuts such as Ctrl+C, never the text you type) or **All keys** (every key you press, including text and passwords).
3. Record as usual.

You can also pick **Keystrokes** on the **Before you start.** screen after you first sign in to the app; that records **Shortcuts only**. Pressing **Continue** without picking it leaves Keystrokes **Off**.

Windows app recordings start with Windows key names in the editor.

## Why is the Keystrokes toggle greyed out?

The toggle is greyed out when the screen recording of the clip at the playhead has no keystroke data. The editor shows "No keystroke data in this recording. Recordings made with the Mac app or Auto Capture include it."

* Only screen recordings made with the Tella Mac or Windows app while **Keystrokes** was on, and Auto Capture takes, include keystroke data. Web recorder and Chrome extension recordings don't, and neither do uploaded videos.
* An Auto Capture take leaves out what it typed from a saved login, so a password never appears.
* Camera-only clips have no screen recording, so they don't show the Keystrokes settings.
* If you see "Couldn't load the keystroke data.", click **Try again**.

If a Mac or Windows app recording has no keystroke data:

1. Turn on the app's **Keystrokes** setting: set it to **Shortcuts only** or **All keys** under **… → Settings → Recording** in the Mac app, or under **Screen recording** in the Windows app's settings.
2. On a Mac, also check the **Input Monitoring** permission: open **System Settings** → **Privacy & Security** → **Input Monitoring** and turn on **Tella** (click **+** to add it if it isn't listed).
3. Quit and reopen Tella, then record again.

Keystrokes can't be added to recordings made before the setting (and, on a Mac, the permission) was on.

## Show keys in web app and Chrome extension recordings

Web app and Chrome extension recordings have no keystroke data. Run a keystroke visualizer such as **Keystroke Pro** while you record instead: it draws each key on your screen, so it's captured in the screen recording itself. Or record with the [Mac app](https://www.tella.com/docs/help/recording/record-a-video-using-the-mac-app.md) or [Windows app](https://www.tella.com/docs/help/recording/record-a-video-using-the-windows-app.md) with **Keystrokes** on.

## Change how keystrokes look

Under the **Keystrokes** toggle:

* Pick a look: **Dark keys**, **Light keys**, **Dark pill** or **Light pill**. Keys shows each key as its own keycap; a pill shows the whole combination as text in one pill.
* **Size**: drag the slider to make the keys smaller or larger.

Click **Configure** for everything else. It opens a **Keystrokes** page with a preview at the top that shows the keys over your clip as you change them. The same four looks sit under **Presets** at the top of the page, so you can try them against the preview. Click the back arrow to return to **Effect**.

## Show only shortcuts or every key

On the **Keystrokes** page (**Configure**), under **Keys**, use **Show** to choose which keys appear:

* **Shortcuts**: only key combinations with a modifier, such as ⌘C or ⌃⇧T. Ordinary typing stays hidden. This is the default.

  Shift on its own doesn't make a shortcut: capital letters and symbols like ? count as typing and stay hidden. Shift still shows with other keys, as in ⇧Tab, ⇧→ or ⌘⇧Z. This matches the Mac app's **Shortcuts only** keystroke setting.
* **All keys**: every key you pressed, including any text you typed.

> [!WARNING]
>
> **All keys** shows everything you typed while recording, including text. Check the video for passwords or other private text before you share it.

## Show typing as words

With **Show** set to **All keys**, use **Typing** to choose how text you typed appears:

* **Keys**: each letter shows as its own keycap. This is the default.
* **Words**: what you type builds up as text in one chip, so typing "hello" shows `h`, `he`, `hel` and so on. Space adds a space and Backspace removes the last letter.

With **Words**, a pause in typing, Return, an arrow key or a shortcut ends the word. Shortcuts such as ⌘K, and keys you press on their own, still show as keycaps. Long text shows only its last 24 characters.

## Move the keys

On the **Keystrokes** page, under **Position**:

* **Align**: place the keys on the **Left**, **Center**, or **Right**.
* **Position**: set how far from the top of the video the keys sit, from 0% to 100%.

## Show Mac or Windows key names

On the **Keystrokes** page, under **Keys**, use **Labels** to choose the keyboard the keys are named for:

* **macOS**: ⌘ ⌥ ⇧ ⌃.
* **Windows**: Ctrl, Alt, Shift, Win.
* **Both**: each shortcut with Mac and Windows keys side by side, as in ⌘ C / Ctrl C, for viewers on either. Keys without a modifier, like Return or a letter, show once.

[https://www.tella.com/video/vid\_cmwe5ghhl004o08if4b4h1rsv/embed?b=0\&title=0\&a=1\&loop=0\&t=0\&muted=0\&wt=0](https://www.tella.com/video/vid_cmwe5ghhl004o08if4b4h1rsv/embed?b=0\&title=0\&a=1\&loop=0\&t=0\&muted=0\&wt=0)

Tella starts with the keyboard your recording was made on. Auto Capture takes start with Windows key names.

## Change how long keys stay on screen, and their colors

On the **Keystrokes** page:

* **Timing** → **Linger**: how long each key stays on screen, from 0.3 to 10 seconds.
* **Timing** → **Animation**: how keys appear and disappear.
* **Colors** → **Background**, **Key**, and **Text**: set your own colors for the container, the keycaps, and the key labels, in place of the look's.


## Related topics

- [Can't record on Mac? Check your permissions](https://www.tella.com/docs/help/mac-app/cant-record-on-mac-check-screen-camera-and-mic-permissions.md)
- [Can't record on Windows? Check your permissions](https://www.tella.com/docs/help/windows-app/cant-record-on-windows-check-camera-mic-permissions.md)
- [Allow camera, mic, and screen access in your browser](https://www.tella.com/docs/help/recording/grant-permissions-for-camera-mic-screen-on-the-web-app-and-chrome-extension.md)
- [Record with the Tella Windows app](https://www.tella.com/docs/help/recording/record-a-video-using-the-windows-app.md)
- [Windows App](https://www.tella.com/docs/changelog/windows-app.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.