Configuration
Settings, the config.toml file, and every option ebb exposes.
Open settings with Open settings (Cmd+, / Ctrl+,). On the
desktop app, every setting mirrors to a plain-text config.toml you can edit
directly.
Settings
Display
- Theme - Light, Dark, or System. The
theme.light,theme.dark, andtheme.systemcommands switch theme from the palette too. - Flow font - the font used for flowed text and the inline editor (see Fonts).
- Argument colors - the colors for aff and neg.
- RFD editor - a vim keybindings toggle for the RFD editor.
Fonts and colors each have a Default reset.
Keyboard
Rebind any command:
Reset restores a command's default. Rebound commands are marked.
Updates (desktop only)
- Auto-update checks - off by default.
- Tournament mode - off by default.
Both mirror to config.toml under [update].
The config file
Location
ebb uses $XDG_CONFIG_HOME/ebb/config.toml when that variable is set.
Otherwise:
- Windows:
%APPDATA%\ebb\config.toml - Everywhere else:
~/.config/ebb/config.toml
The file ships the full keybinding set inline, so you can rebind by editing it.
Live and lossless
Changes saved in the file apply live, changes made in the app write back to the file, and any comments you add are preserved.
Top-level keys
| Key | Type / values | Default |
|---|---|---|
theme | "light" | "dark" | "system" | "system" |
flow_font | font id (see Fonts) | "dm-sans" |
sidebar_collapsed | boolean | false |
rfd_open | boolean | false |
rfd_vim | boolean | false |
aff_color | "#rrggbb" (omit key to reset to theme default) | unset |
neg_color | "#rrggbb" (omit key to reset to theme default) | unset |
Tables
[keymap]- onecommandId = "chord"line for every command. Unbound commands ship as"". Edit a value to rebind; a value equal to the default is treated as no override.[update]-auto_check_enabled(boolean, defaultfalse) andtournament_mode(boolean, defaultfalse).
Example
theme = "dark"
flow_font = "commit-mono"
sidebar_collapsed = false
rfd_open = false
rfd_vim = true
# aff_color / neg_color omitted -> use theme defaults
[keymap]
"format.toggleBold" = "Meta+b"
"sheet.next" = "]"
# ... full set shipped inline ...
[update]
auto_check_enabled = false
tournament_mode = falseFonts
The flow font is set under Settings > Display > Flow font; the flow_font
id used in config.toml is in parentheses.
| Font | flow_font id | Kind |
|---|---|---|
| Commit Mono | commit-mono | mono |
| IBM Plex Mono | plex-mono | mono |
| DM Sans | dm-sans | sans - default |
| IBM Plex Sans | plex-sans | sans |
| Cabin | cabin | sans |
| Lato | lato | sans |
| Open Sans | open-sans | sans |