JJUI loads configuration on start up from the system's config directory.
- MacOS:
~/Library/Application Support/jjui/config.toml
- Linux:
~/.config/jjui/config.toml
- Windows:
%AppData%/jjui/config.toml
(Might have to manually create folder). - Custom:
$JJUI_CONFIG_DIR/config.toml
You can edit the configuration in your $EDITOR
by passing the --config
argument:
jjui --config
Key bindings
Key binding support is limited by the key handling capabilities of the terminal emulator you are using.
Note: Order of the modifiers matter; for example ctrl+alt+up
is read as alt+ctrl+up
, so alt
should come before ctrl
.
Note: shift
combined with letters is not supported by the underlying library that jjui
is using for rendering and key handling. So, ctrl+shift+f
is read as ctrl+f
. However, shift+f
can be defined as F
, and it should work.
Colours and Themes
UI appearance is configured through the theming system. You can customize the colors and styles of various UI elements in your config.toml file or by creating custom theme files.
For example, to customize the appearance of selected items:
[ui.colors]
"selected" = { bg = "your colour" }
For more detailed customization options, see the Themes page.
Default configuration
You can find the default configuration in the repo here: https://github.com/idursun/jjui/blob/main/internal/config/default/config.toml