Skip to content

Configuration

Find a setting

Change Guide
Colors, cursor, selection, typing effects Terminal appearance
Tiling, worlds, pane padding, transitions Workspace appearance
Shortcuts, prefix, command palette, menus Keyboard and menus
On-screen keys and buttons Touch controls
File browsing and a custom editor Filetree
Microphone transcription Dictation
Shell, fonts, server defaults Server settings
Browser logins Chromium profiles
Neovim and tmux pane navigation Navigation setup
JavaScript panels Mods

Configuration files

  • Desktop: ~/.config/graffitty/client.toml.
  • Android: client.toml in the app's private config directory.
  • Override: XDG_CONFIG_HOME changes the configuration directory.
  • Server settings: shells, fonts, dictation, navigation, and the filetree command belong in server.toml on the session host.

Validate before restarting:

gft-gui --check-config

Layering and reload

Priority, lowest first Source
1 Built-in defaults
2 Automatic client.toml, unless --no-config
3 Explicit --config=PATH.toml files, in command order

Later values win. Tables merge by key; arrays replace earlier arrays. --no-config still allows explicit files. Worlds may override appearance.

Change Apply it
Client file Validate, detach sessions to keep, then close the detached window and relaunch
Server file Save a checkpoint and restart the server
Fonts dialog Immediate; no restart

Do not choose Close Session when preserving running programs.

Interface language

  • Choose View () → Language, or set language = "ko" at the top of client.toml.
  • "auto" uses the device's system language.
  • Each client keeps its choice when switching servers.

Notifications

  • View () → Notifications: open notification history.
  • Hover a notification to pause dismissal.
  • History keeps the last 1,000 notices until cleared or the app exits.

Desktop file locations

Kind Default Override base
config ~/.config/graffitty XDG_CONFIG_HOME
data ~/.local/share/graffitty XDG_DATA_HOME
cache ~/.cache/graffitty XDG_CACHE_HOME
state ~/.local/state/graffitty XDG_STATE_HOME

Paths in client.toml

File paths (fonts, sounds, mods, worlds, and SwitchWorld menu items) may start with ~/ or with one of the kinds above:

[world]
path = "%(data)/worlds/bistro/bistro.pck"

%(config), %(data), %(cache) and %(state) are the directories in the table, including their overrides. Other relative font and mod paths resolve beside the file that sets them.