Skip to content

Latest commit

 

History

History
124 lines (110 loc) · 2.71 KB

themes.md

File metadata and controls

124 lines (110 loc) · 2.71 KB
Raw

The bar can be themed either by specifying a pre-complied theme or overriding defaults in the configuration.
We differentiate between themes and icon sets.

Choosing your theme and icon set

To use a theme or icon set other than the default, add them to your configuration file like so:

theme = "solarized-dark"
icons = "awesome"

You can also use your own custom theme:

[theme]
file = "<file>"

where <file> can be either a filename or a full path and will be checked in this order:

  1. If full path given, then use it as is: /home/foo/custom_theme.toml
  2. If filename given, e.g. "custom_theme.toml", then first check XDG_CONFIG_HOME/i3status-rust/themes
  3. Otherwise look for it in /usr/share/i3status-rust/themes

Example theme file can be found in example/theme/solarized-dark.toml.

Available themes:

  • plain (default)
  • solarized-dark
  • solarized-light
  • slick
  • modern
  • bad-wolf
  • gruvbox-light
  • gruvbox-dark
  • space-villain

Available icon sets:

  • none (default)
  • awesome (Font Awesome 4.x)
  • awesome5 (Font Awesome 5.x)
  • material

Note: In order to use the material icon set, you need a patched material icons font which can be found here. Make sure to pass it in your i3 configuration bar block.

Overriding themes and icon sets

Create a block in the configuration called theme or icons like so:

[theme]
name = "solarized-dark"
[theme.overrides]
idle_bg = "#123456"
idle_fg = "#abcdef"

[icons]
name = "awesome"
[icons.overrides]
bat = " | | "
bat_full = " |X| "
bat_charging = " |^| "
bat_discharging = " |v| "

Example configurations can be found as example_theme.toml and example_icon.toml.

Available theme overrides

  • alternating_tint_bg
  • alternating_tint_fg
  • critical_bg
  • critical_fg
  • good_bg
  • good_fg
  • idle_bg
  • idle_fg
  • info_bg
  • info_fg
  • separator_bg
  • separator_fg
  • separator
  • warning_bg
  • warning_fg

Available icon overrides

  • backlight_empty
  • backlight_full
  • backlight_partial1
  • backlight_partial2
  • backlight_partial3
  • bat_charging
  • bat_discharging
  • bat_full
  • bat
  • cogs
  • cpu
  • gpu
  • mail
  • memory_mem
  • memory_swap
  • music_next
  • music_pause
  • music_play
  • music_prev
  • music
  • net_down
  • net_up
  • net_wired
  • net_wireless
  • ping
  • thermometer
  • time
  • toggle_off
  • toggle_on
  • update
  • uptime
  • volume_empty
  • volume_full
  • volume_half
  • volume_muted
  • weather_clouds
  • weather_default
  • weather_rain
  • weather_snow
  • weather_sun
  • weather_thunder
  • xrandr