Repository files navigation

Very resourcefriendly and feature-rich replacement for i3status, written in pure Rust

For available blocks and detailed documentation visit theWiki

This is a replacement for i3status, aiming to provide the most feature-complete and resource friendly implementation of the i3bar protocol available. We are currently looking for help in implementing more Blocks and Themes! It supports:

• flexibility through theming
• icons (optional)
• individual update intervals per block to reduce system calls
• click actions
• blocks can trigger updates asynchronously, which allows for things like dbus signaling, to avoid periodic refreshing of data that rarely changes (example: music block)

i3, rustc, libdbus-dev and cargo. Only tested on Arch Linux. Compilation is only tested with the latest Rust stable version. If you use a distro with old Rust packages (looking at you, Ubuntu!), fall back to rustup or find a precompiled package for your distro.

Optional:

• alsa-utils For the volume block
• lm_sensors For the temperature block
• speedtest-cli For the speedtest block
• Font Awesome, foricons="awesome". Version 5 of the font is causing some issues (see#130), so for now we recommend version 4. If you have access to the AUR, check outttf-font-awesome-4.
• gperftools For dev builds, needed to profile block performance and bottlenecks.
• powerline-fonts For all themes using the powerline arrow char. Recommended. Seepowerline on GitHub

1. If you are using Arch Linux, you can install from the AUR:i3status-rust-git and proceed to step 3. Otherwise, clone the repository:git clone https://github.com/XYunknown/i3status-rust.git

2. runcd i3status-rust && cargo build --release

3. Editexample_config.toml to your liking and put it to a sensible place (e.g.~/.config/i3/status.toml)

4. Edit your i3 bar configuration to usei3status-rust. For example:

   bar {      font pango:DejaVu Sans Mono, FontAwesome 12      position top      status_command path/to/i3status-rs path/to/config.toml      colors {            separator #666666            background #222222            statusline #dddddd            focused_workspace #0088CC #0088CC #ffffff            active_workspace #333333 #333333 #ffffff            inactive_workspace #333333 #333333 #888888            urgent_workspace #2f343a #900000 #ffffff      }}

   In order to use the built-in support for the Font Awesome icon set, you will need to include it in thefont parameter, as above. Check to make sure that "FontAwesome" will correctly identify the font by usingfc-match, e.g.

   $ fc-match FontAwesomefontawesome-webfont.ttf:"FontAwesome""Regular"

   (Note that the name of the Font Awesome font may have changed in version 5. See#130 for some discussion.)

5. Reload i3:i3 reload

i3status-rs is very much still in development, so breaking changes before a 1.0.0 release will occur. Following are guides on how to update your configurations to match breaking changes.

The battery block now uses the device name (usually BAT0) instead of the number after 'BAT'. This makes the block compatible with device names not starting with 'BAT'. To see your battery device(s) executels /sys/class/power_supply

Recently, the configuration has been changed:

• Switched from JSON to TOML
• Inlined the themes and icons configurations into the new main configuration
• Removed the command-line arguments--theme and--icons

Update your configuration to match the structure of the currentexample_config.toml:

theme ="solarized-dark"icons ="awesome"[[block]]block ="disk_space"path ="/"alias ="/"info_type ="available"unit ="GB"interval =20[[block]]block ="memory"display_type ="memory"format_mem ="{Mup}%"format_swap ="{SUp}%"[[block]]block ="cpu"interval =1[[block]]block ="load"interval =1format ="{1m}"[[block]]block ="sound"[[block]]block ="time"interval =60format ="%a %d/%m %R"

Things to note:

• Every[[block]] has to contain ablock-field to identify the block to create
• Boththeme andicons can be defined as tables, seeexample_theme.toml andexample_icon.toml