Files
tty7/docs/terminal/mouse-and-scrolling.mdx
T
l0ng-ai 84935813d5 feat(terminal): the mouse wheel no longer zooms the font by default
mouse_zoom_modifier now defaults to none. The platform modifier is cmd on
macOS, held for so much else that the font jumped size mid-scroll (#668).
Picking a modifier in Settings brings the wheel zoom back; cmd+/cmd- are
unchanged.
2026-09-27 10:42:02 +08:00

78 lines
3.0 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Mouse, scrolling, and the bell"
description: "How the pointer, the wheel, and ^G behave — and how to change each."
---
## Scrolling
The wheel and trackpad scroll the pane's scrollback. All of it lives under
**Settings → Terminal → Scrolling**:
| Setting | Default | What it does |
|---|---|---|
| **Scrollback** | 10,000 lines | How much history each pane keeps, up to 100,000. Applies to new panes. |
| **Scroll speed** | 1.0 | A multiplier on wheel scrolling (0.1–10). |
| **Smooth scrolling** | On | Eases each wheel notch into place over a few frames instead of jumping the whole way. Trackpads scroll continuously already and are unaffected. |
The wheel only ever scrolls. To zoom the font with it too, pick a modifier
under **Settings → Terminal** (or set
`mouse_zoom_modifier`); <kbd>⌘ +</kbd> / <kbd>⌘ −</kbd> zoom either way.
A scrollbar appears down the right edge of the pane as soon as the view moves,
and fades out once it stops — the same bar the sidebar and every list in the app
use. Drag its thumb to travel the whole scrollback at once, or click the track
to jump. A pane sitting at the live edge stays bare, however much output is
running through it.
## The pointer
Under **Settings → Keyboard & Mouse → Mouse**:
| Setting | Default | What it does |
|---|---|---|
| **Focus follows mouse** | Off | Hovering a pane focuses it without a click. |
| **Hide mouse while typing** | On | The pointer disappears as you type and returns on the next move. |
| **Report mouse to apps** | On | Full-screen programs — vim, tmux, `htop` — get clicks and scroll events themselves. Hold <kbd>⇧</kbd> to keep a gesture local and select text instead. |
<Tip>
If selecting text inside `vim` or `less` grabs the app's own selection instead
of yours, hold <kbd>⇧</kbd> while you drag.
</Tip>
## Font size
| | |
|---|---|
| <kbd>⌘ +</kbd> · <kbd>⌘ −</kbd> | Bigger · smaller |
| <kbd>⌘ 0</kbd> | Back to the configured size |
| <kbd>⌘</kbd> + wheel | Zoom by scrolling over a terminal |
The base size is **Settings → Appearance → Terminal text → Terminal font size**, 15 px by
default. The rest of the interface has its own size — **Interface font size**,
16 px, adjustable from 12 to 24 — so you can scale the chrome without touching
the terminal grid, or the other way round.
## The bell
**Settings → Terminal → Bell → Terminal bell** decides what `^G` does:
| Mode | Behaviour |
|---|---|
| **Off** | Nothing |
| **Visual** *(default)* | A brief flash |
| **Audible** | The system sound |
| **Both** | Flash and sound |
## Command-finished notifications
**Settings → General → Notifications** posts a desktop notification when a
foreground command finishes:
- **Notify on command finish** — *Never*, *When unfocused* (default), or
*Always*
- **Notify threshold** — how long a command has to run to qualify, 10 seconds by
default
Coding agents use the same policy for their own notifications.
[Agent status →](/agents/status)