Skip to content
Snippets Groups Projects
J. Konrad Tegtmeier-Rottach's avatar
jktr authored
f429baaa
History

qbar

qbar is a status command for sway and i3.

Installation

Compiling from Source

Building qbar requires stack. To build it run:

stack build

You can also use the scripts in the bin-directory (all scripts will rebuild the project if required):

# Launch as swaybar status command while redirecting stderr to shell
./bin/run-sway default

# Run the binary directly (mostly used to control the bar via rpc)
./bin/run --help

# Install the binary to ~/.local/bin (this can also install tab completions)
./bin/install

Configuration

All configuration is currently done with command line arguments. The executable uses a command-style interface (e.g. qbar theme rainbow) which supports --help at every level of the tree. It also provides bash, zsh and fish tab completions.

Sway

Use the following status_command:

qbar server swaybar default

You can specify a custom set of blocks:

qbar server swaybar date cpu network script ~/bin/my_script

i3

i3 runs the status command for every screen that shows a bar. To reuse the output of your primary display you can use mirror mode:

# Configure for primary display
qbar server i3bar default

# Configure for other displays
qbar mirror i3bar

Theming is not supported on mirrored servers.