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.tomlin the app's privateconfigdirectory. - Override:
XDG_CONFIG_HOMEchanges the configuration directory. - Server settings: shells, fonts, dictation, navigation, and the filetree command belong in
server.tomlon the session host.
Validate before restarting:
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 ofclient.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:
%(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.