Skip to content

Typing effects settings

Edit client.toml to tune effects. Start with Terminal appearance or the effects gallery to choose a look.

Add typing effects

Cursor trails

Choose View () → Cursor Trail, or configure:

[terminal.effects.cursor_trail]
delay_ms = 1 # 0 disables trails.
style = "lightning" # smear, blaze, lightning

Tune individual styles

[terminal.effects.cursor_trail]
delay_ms = 1 # 0 disables trails.
style = "lightning" # smear, blaze, lightning
start_threshold = [2, 2] # Cells.
decay = [0.1, 0.4] # Smear corner decay, in seconds.

[terminal.effects.cursor_trail.smear]
color = "none" # Follow the cursor color.

[terminal.effects.cursor_trail.blaze]
duration = 0.5
color = "#ffb929"
accent_color = "#ff0000"

[terminal.effects.cursor_trail.lightning]
duration = 0.14
color = "#ffb929"
glow_color = "#bd0000"
jaggedness = 0.085
core_width = 1.15
glow_width = 5.5

Each style keeps its own settings when you switch styles.

Typing particles and pane zoom

[terminal.effects.typing_particles]
preset = "sparks" # none, sparks, dots, fireworks, flames, glitter
amount = 6 # Particles per keystroke.

[terminal.effects.typing_pane_zoom]
scale = 1.1 # 10% larger while typing; 1.0 disables.

Pane zoom enlarges the typing pane without resizing the terminal grid.

Adaptive zoom can keep a pane and its related tools in view.

In client.toml:

[effects.camera]
zoom_mode = "adaptive"
adaptive_group = { main_view = true, filetree = 0.25, chromium = false, spawned = false, graph = false }
Value Behavior
false Do not include that group
true Include it whenever it fits
0–1 Limit how much of the frame may be empty gap
  • Groups include the main area, filetree, browser, panes launched with gft run, and graph neighbors.
  • Manual pan or zoom pauses adaptive movement; fresh typing resumes it.
  • The Effects… dialog also has group controls.

Effects profiles

Choose View () → Effects Profile.

Profile Result
World Default Use the world's effects
Off Disable decorative effects
Mild Subtle typing motion and surface effects
Exaggerated Stronger motion and surface effects
[effects]
profile = "mild"
disabled = ["camera.tilt"]

[effects.profiles.calm.camera]
zoom = 1.15
tilt_limit_deg = 3

[effects.profiles.calm.sheet]
ripple = 0.2
  • Custom profiles use the same settings as [effects], under [effects.profiles.NAME].
  • Names use lowercase letters, digits, - and _; built-in names are reserved.
  • Profile camera zoom applies in Typing zoom mode. Adaptive zoom keeps its own fit.

Remembered choices

  • Menu changes to profiles, effects, trails, particles, pane zoom and transitions persist between launches.
  • Values explicitly set in client.toml take precedence at startup.
  • Transitions are remembered per world.
  • To reset remembered choices, delete ~/.local/state/graffitty/remembered.toml (or the equivalent under XDG_STATE_HOME).
  • --no-config skips remembered choices.

See cursor, selection, clipboard, scrolling, and copy-mode settings.

See application rules.