Awesome Open Source
Awesome Open Source

Bar Config

Crate for easily creating system bars/panels/docks.

The goal of this crate is to make it as simple as possible to create complex bars/panels/docks for linux without having to worry about anything but rendering.

To get started with the crate, a new bar needs to be created. This is done using the load method in the Bar.


This example shows you how to create a simple bar with three components which prints the state of every component in the console every time it's updated.

use std::io::Cursor;

use bar_config::Bar;

fn main() {
    // Create input configuration input with three components
    let input = Cursor::new(String::from(
         height: 30\n\
         - { name: \"DVI-1\" }\n\
         - { text: \"Hello, World!\" }\n\
         - { name: \"clock\" }\n\
         - { text: \"VOLUME\" }",

    // Load the bar configuration from the input
    let mut bar = Bar::load(input).unwrap();

    // Render the state of the bar at startup

    loop {
        // Wait for any update to the bar
        let _ = bar.recv();

        // Print all components every time one changes

// Prints the text of every component in the configuration
fn print_bar(bar: &Bar) {
    for comp in bar.components() {
        if let Some(text) = comp.text() {
            print!("{}\t", text);

Bar Configuration Grammar

This is the grammar for the user configuration. It is designed to map to data formats like YAML or JSON but should also allow an easy representation in Rust.

# Legend
#     !   Field is required
#     ?   Field is optional

# Root element of the bar
    # General configuration options
    !height: u8
    ?position: Position
    ?background: Background
    ?border: Border
    !monitors: [Monitor]

    # Default fallback values for components
    ?defaults: ComponentSettings

    # Component containers
    ?left: [Component]
    ?center: [Component]
    ?right: [Component]

# A single component/block/module in the bar
    # Name used to identify which component should be loaded
    ?name: String

    # State of a component (inlined struct).

    # Extra options are passed to the component
    ?_: T

# Default options available for every component

# Full component state which contains everything necessary for rendering a component.
    ?foreground: (r: u8, g: u8, b: u8, a: u8)
    ?background: Background
    ?width: u8
    ?padding: u8
    ?offset_x: i8
    ?offset_y: i8
    ?fonts: [Font]

# Background of a component or the bar
    !Image(path: String) | Color(r: u8, g: u8, b: u8, a: u8)

# Dinstinct identification for a font
    !name: String
    !size: u8

# Distinct identification for a monitor
    !name: String
    ?fallback_names: [String]

# Border separating the bar from the rest of the WM
    !height: u8
    !color: (r: u8, g: u8, b: u8, a: u8)

# Available positions for the bar
    !Top | Bottom

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Rust (63,395
Linux (16,549
Panel (349
Bar (170
Related Projects