melonbar - A concurrent, hackable bar/panel for X written in Go.
INSTALLATION
go get github.com/onodera-punpun/melonbar
Or for a binary that includes embedded static files:
packr2 get github.com/onodera-punpun/melonbar
melonbar depends on Go 1.9 or newer, gnuplot, and
packr2.
USAGE
The idea is that this bar is very "simple" to configure by just modifying the source code, à la suckless.
Users can configure the position, width, height and font of the bar in
main.go. A bar consist of various blocks that display info, these blocks are
functions definded in blocks.go and exectured in a goroutine in main.go.
CREATING BLOCK FUNCTIONS
On top of each block function you should run bar.initBlock(), this generates a
block object, and is where most of the configuration happens. Here is a short
explanation of each parameter from left to right:
- The name of the block, this is gets used as the name of the block map key.
(
string) - The initial string the block should display. (
string) - The width of the block. (
int) - The aligment of the text, this can be
'l'for left aligment,'c'for center aligment'r'for right aligment and'a'for absolute center aligment. (rune) - Additional x offset to further tweak the location of the text. (
int) - The foreground color of the block in hexadecimal. (
string) - The background color of the block in hexadecimal. (
string)
It is possible to bind mousebindings to a block using using:
block.actions["buttonN"] = func() {
// Do stuff.
}When you've gathered all information you can update the block values using for
example block.bg = "#FF0000" or block.txt = "Hello World!" and executing
bar.redraw <- block.
AUTHORS
Camille Scholtz