ebb

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, and theme.system commands 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:

Filter the list to the command you want.
Press Record on that command.
Press the chord you want to bind.

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

KeyType / valuesDefault
theme"light" | "dark" | "system""system"
flow_fontfont id (see Fonts)"dm-sans"
sidebar_collapsedbooleanfalse
rfd_openbooleanfalse
rfd_vimbooleanfalse
aff_color"#rrggbb" (omit key to reset to theme default)unset
neg_color"#rrggbb" (omit key to reset to theme default)unset

Tables

  • [keymap] - one commandId = "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, default false) and tournament_mode (boolean, default false).

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 = false

Fonts

The flow font is set under Settings > Display > Flow font; the flow_font id used in config.toml is in parentheses.

Fontflow_font idKind
Commit Monocommit-monomono
IBM Plex Monoplex-monomono
DM Sansdm-sanssans - default
IBM Plex Sansplex-sanssans
Cabincabinsans
Latolatosans
Open Sansopen-sanssans

On this page