Skip to content

Config Path

EasyBar can start without a custom config file. Create one only when you want to override the built-in defaults.

When present, EasyBar reads its runtime config from:

~/.config/easybar/config.toml

You can override that path with:

EASYBAR_CONFIG_PATH=/path/to/config.toml

Theme path

Custom themes are loaded from the directory configured in config.toml:

[theme]
themes_dir = "~/.config/easybar/themes"

By default, this is usually next to your config file:

~/.config/easybar/themes

Theme files use the theme name plus .toml.

Example:

~/.config/easybar/themes/my-theme.toml

Then select it with:

[theme]
name = "my-theme"

Bundled themes are shipped inside the app bundle and are used when no matching custom theme exists in themes_dir.

Example files

The repository ships two config examples:

  • config.defaults.toml Full reference file with the current default values and supported sections.
  • config.minimal.toml Smaller optional starter override for grouping battery and Wi-Fi and enabling Wi-Fi details.

Use config.defaults.toml when you want the complete reference. Use config.minimal.toml when you want a shorter customization starting point.