DEV Community

Cover image for Breto - A Multi-UI Status Bar

Breto - A Multi-UI Status Bar

J. R. Swab
Hacker, Content Creator, Linux Enthusiast, Dvorak Typist, & Eagle Scout | Col. 3:17
Originally published at ・2 min read

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:


  • Date & Time
  • Weather via
  • Total RAM not used
  • Total space left in the home directory
  • Icons

Current UIs:

  • DWM
  • i3wm
  • tmux


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:

  • Tempurature
  • Disk
  • RAM
  • Volume
  • Syncthingt
  • Dropboxt
  • Redshift

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:

  • Simply set ui.Dwm(status), compile, and execute.
  • If you already have a startup script for DWM just add a new line for go-status

Addng to Tmux:

  • set -g status-right "#($HOME/PATHTO/tmux-status)"
    • If you have colors in this setting add the path at the end of the string
    • Be sure to use the correct path and name of the file you built with GO.
    • Running mv go-status ~/tmux-status will allow you to use "($HOME/tmux-status)" in your config.
  • set -g status-right-length 53
    • If you are not using all the custom packages this number can be lower
    • This also will vary based on screen size. 53 is the minimum that worke for all current blocks
    • If you notice the status getting cut off just increase the number and reload tmux.

Adding to i3wm:

  • In the i3wm confige file, change status_command ... to status_command PATH/TO/go-status Options:

  1. Add your area to the weather function
    • Area Code: ''
    • City: ''
  2. Add tweaks to blocks/wttr.go


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



Discussion (0)

Forem Open with the Forem app