> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Full-screen apps

Run Vim, Emacs, and other full-screen apps with configurable mouse reporting and padding.

## Mouse and scroll reporting

Warp supports configuring how to handle mouse and scroll events. They can be sent to the currently running app, e.g. `vim`, or kept and handled by Warp.

Note

Mouse reporting must be enabled to also toggle scroll reporting.

Once mouse reporting is enabled, Warp will use ANSI escape sequences to communicate mouse events to the running app.

Note

If you want a mouse event to go to Warp instead (for example, for text selection) without disabling mouse reporting, you can hold the `SHIFT` key.

### How to access it

-   From **Settings** > **Features** > **Terminal** > **Enable Mouse Reporting**
    -   Scroll Reporting can be enabled after toggling **Enable Mouse Reporting**
-   From the [Command Palette](/terminal/command-palette/), search for “Toggle Mouse Reporting”
-   From the macOS Menu, **View** > **Toggle Mouse Reporting**

### How it works

## Padding

Warp supports configuring how much padding surrounds full-screen apps. The default is 0 pixel padding, but this can be changed to a custom padding amount or to match the padding in the block list.

Note

Warp allows you to scale your terminal by fractions of a cell width | height. When your terminal size is not perfectly aligned to a cell width | height, the extra space appears as padding on the right | bottom.

### How to access it

-   Go to **Settings** > **Appearance** > **Full-screen Apps** or from the [Command Palette](/terminal/command-palette/) search for “Appearance”
    -   **Use custom padding in alt-screen** is enabled by default, you can disable it to match the block list padding
        -   Set the desired uniform padding (px) pixels, which is set to 0px by default

Caution

Some full-screen applications don’t behave well when resizing. If you are experiencing rendering issues with full screen apps, try turning this setting off. This will ensure that full-screen apps don’t need to resize when starting up.

![alt-screen padding setting](/_astro/padding-settings.BTFzXcH0_23m6wi.webp?dpl=dpl_B7dHxhjj41Pn5q8ShYeu8RqsHQb3)

The alt-screen padding setting in appearance preferences.

## Kitty keyboard protocol

Warp supports the [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/) (CSI u progressive enhancement) so full-screen apps can read keystrokes that legacy terminal escape sequences can’t represent — for example, distinguishing `Ctrl+I` from `Tab`, capturing modifier-only key events, or detecting key release events.

When a running app advertises that it supports the protocol, Warp emits the extended escape sequences automatically. No configuration is required.

-   **Supported in**: Vim, Neovim, Emacs, tmux, helix, and other modern TUI apps that opt into CSI u.
-   **Falls back to legacy encoding** when the running app doesn’t request progressive enhancement, so older programs keep working unchanged.

Note

If a TUI app reports unexpected key events after upgrading Warp, confirm the app itself supports the Kitty keyboard protocol. Most apps require an explicit opt-in (for example, `:set keyprotocol` in Neovim).