J. R. Swab

Breto; A Multi-UI Status Bar

Categories: [Technology]
Tags: [software], [programming], [open-source], [apps]

View on Github

Breto (originally called Go-Status) is a small project I wrote a few months back to display the time and date in DWM. It's written in Go and the name means "shelf" in Esperanto.

Even though it started as a way to display the time in my DWM bar it now does much more and even works in other window managers.

If you have any feature you'd like to see added feel free to send a pull request or open an issue. I would like to add as many blocks as is deemed useful by anyone using this application.

Current Features:


Current UIs:


To display icons in DWM:

  1. Install FontAwesome v4
  2. Set FontAwesome as the second font in dwm/config.h
    • eg. static const char *fonts[] = { "Source Code Pro:size=13", "FontAwesome:size=14" };
      • Relaunch DWM

Current Icons:

Currently, the icons are much too small to be useful in Tmux or i3wm without further configuration.

If you have an easy way to display FontAwesome icons at the same scale as the terminal text please submit a pull request.

How To Use:

  1. Open main.go in a text editor.
  2. If cloned from Gitlab change the custom package directories from Github to Gitlab.
  3. Edit the last status variable to contain the blocks you wish to use.
  4. Change the last line to match your UI (eg, ui.Dwm(status)).
  5. Build the binary.
  6. Edit your config file to use the new binary.

Adding to DWM:

Addng to Tmux:

Adding to i3wm:

Wttr.in Options:

  1. Add your area to the weather function
    • Area Code: 'wttr.in/~00000?format=2'
    • City: 'wttr.in/~Paris?format=2'
  2. Add tweaks to blocks/wttr.go


  1. Get a proper name
  2. Scale icons in tmux and i3wm