Skip to content
A status bar written in Go.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Go Status Bar

This is a script written with Go to display information. Currently tested with DWM, i3wm, and tmux.

Current Features:

Master Branch:


  • 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:    
  • Syncthing: 
  • Dropbox: 
  • Redshift: 

Currently, the icons are much too small to be usefull 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 Github change the custom package directories from Gitlab to Github.
  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



You can’t perform that action at this time.