Where Does gitui Store Key Bindings and Theme?
gitui key bindings and theme files under ~/.config, in RON format.
Last updated
gitui keeps its settings in a gitui folder under ~/.config, as two small RON files: one for key bindings and one for the theme. Fresh installs have neither file, and the app runs on compiled in defaults until you create them.
RON syntax trips up newcomers, since it looks like Rust struct literals rather than JSON or YAML. Copy the documented samples as a starting point instead of writing from memory. A syntax error in either file falls back visibly, so test changes by relaunching rather than guessing.
Where gitui stores this, by platform
~/.config/gitui
Respects $XDG_CONFIG_HOME when set. Files are key_config.ron for bindings and theme.ron for colors. Create them only when defaults stop sufficing, since missing files simply mean defaults.
~/.config/gitui
Same directory layout and file names as Linux. The pair copies cleanly between platforms with no path adjustments in normal setups.
Frequently asked questions
how do i reset gitui settings
Delete the gitui config directory with gitui closed and relaunch. Defaults regenerate, clearing broken keymaps and theme errors. Your repositories are untouched, since gitui stores no repo state outside git itself.
how do i move gitui key bindings to a new pc
Copy the whole gitui config directory to the new machine. Key bindings and theme travel together in two small text files with no absolute paths, so they work immediately on arrival.
Notice an outdated path? Let us know.