i3status-rs

An i3bar compliant program written in rust.

This library provides support for creating custom status bars for i3bar.

Blocks are run independent of each other and can be set to run at different intervals from each other.

Running shell scripts through this interface and click callbacks will eventually be supported.

Examples

The basic rundown for usage of this library is:

• Create a I3Status object through I3Status::new()
• Add blocks (Either from the library, or custom-coded) with .add_block()
• call .run()

A simple code example would be:

extern crate i3status;
use i3status::I3Status;
use i3status::block::Time;

fn main()
{
    let time_block = Time::new("%a %F %T");
    let mut i3s = I3Status::new();
    i3s.add_block(time_block, "Time");
    i3s.run();
}

This will output something similar to Sun Mar 13 14:37:31 2016 and will update once a second.

Custom Blocks

If you want to create a custom status block, you will have to create a struct and impl Block.

Care should be taken that the bulk of the processing take place within the update function and that little processing is done during the get_status function. This is because the get_status function is currently being called whenever any block is updated.