Skip to content

Workspace appearance

Choose a world and adjust spacing or motion. Saved settings go in client.toml; see Configuration for its location.

Choose a world

[world]
path = "flat-2d"

Use flat-3d for depth effects. Hardware-rendered desktops default to Flat 3D; Android, iOS, and software rendering default to Flat 2D.

Add a downloaded world

  1. Extract the world into ~/.local/share/graffitty/worlds/, so that <name>/<name>.pck and <name>/<name>.json sit together.
  2. Restart Graffitty and choose it under View → World.
  3. To start in it, set path to the world's id:
[world]
path = "bistro"

A value without / or a .pck suffix names an installed world by id. To load a pack from elsewhere, give its path, for example "%(data)/worlds/bistro/bistro.pck" (see Paths in client.toml).

Update both files together; app updates do not update downloaded worlds. Bistro is published at graffitty/bistro-world.

Adjust pane spacing

[tiling]
gap = 8

[worlds.flat-2d.terminal_window]
padding = [8, 8, 8, 8]
corner_radius = 12

Padding runs left, top, right, bottom. Use worlds.flat-3d for Flat 3D. Set gap or corner radius to 0 for no gap or square corners.

Zoom and pan

  • Pinch, or Cmd+scroll on macOS / Ctrl+scroll elsewhere, to zoom.
  • Right-button drag to pan.
  • Choose View → Main Area to reset framing.

Each tab remembers its view. Rename panes and tabs with gft rename-pane and gft rename-tab; omit the name to resume automatic titles.

Reduce motion or frame rate

Choose View → Tab Transition / Session Transition → None to stop transition motion. See the effects gallery for other choices.

[window]
max_fps = 60
inactive_max_fps = 30

Both caps accept 1–240; the inactive cap cannot exceed the active cap. Display refresh and VSync can limit the actual rate.

See World settings for per-world overrides, backdrop blur, and transition configuration. Use letter and dust settings for session-flight tuning.