Skip to content
A status bar written in Go.
Branch: master
Clone or download
Latest commit ec6d370 Oct 11, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
blocks Created new package for all icons. Jul 4, 2019
icons Added Structs Oct 11, 2019
ui added package to simplify usage across different user interfaces. Jun 2, 2019
LICENSE Merge branch 'master' of into dev… Oct 10, 2019
go.mod Added Structs Oct 11, 2019
main.go Added Structs Oct 11, 2019


A status bar written in Go. Currently tested with DWM, i3wm, and tmux.

Current Features:

Master Branch:


  • Date & Time
  • Weather via
  • Total RAM not used
  • Total disk space left in the binary's present partition.
  • Total battery percentage (commented out by default)
  • 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" };
  3. Relaunch DWM

To display in tmux or i3wm:

  1. Install FontAwesome v4.
    • Keep in mind that the icons are currently very small.
    • Research in progess.

Current Icons:

  • Tempurature: 
  • Disk: 
  • RAM: 
  • Volume:    
  • Syncthing: 
  • Dropbox: 
  • Redshift: 
  • Battery: 

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. Edit the last status variable to contain the blocks you wish to use.
  3. Change the last line to match your UI (eg, ui.Dwm(status)).
  4. Build the binary.
  5. 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.