gobar

command module
v0.0.0-...-4079670 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 4, 2016 License: MIT Imports: 21 Imported by: 0

README

Build Status

gobar is a minimalistic X status bar written in pure Go.

Supports xinerama, EWMH, font antialiasing and possibly some other fancy looking names and shortcuts.

screenshot

Two gobar instances.

Top with some conky metrics. Bottom with wingo workspaces (bash + wingo-cmd for now) and date.

screenshot

installation

First, you have to get Go. Note that version >= 1.1 is required.

Then, just

$ go get github.com/KenjiTakahashi/gobar

should get you going.

usage

Command line options reference follows:

-h --help displays help message and exits.

--bottom places bar on bottom of the screen (default is on top).

--geometry= takes comma separated list of monitor geometries.

Each geometry element is in form of <width>x<height>+<x>+<y>. Where <width> can also take a special value of M, meaning "take all available space".

If omitted, or if number of specified geometries is lower than number of monitors, a default of Mx16+0+0 is used for not specified monitors.

--fonts= takes comma separated list of fonts.

Each font element is in form of <ttf file path>[:<font size>].

If omitted, or if incorrect path is specified, defaults to whatever it can find in fontconfig configuration.

If <font size> part is omitted or incorrect, defaults to 12.

--fg= takes main foreground color. Should be in form 0xAARRGGBB.

--bg= takes main background color. Should be in form 0xAARRGGBB.

Other than that, an input string should be piped into the gobar executable.

A really simple example could be displaying current date and time.

$ while :; do date; sleep 1; done | gobar

Special tokens can also be used in the input string to allow nice formatting.

Input string formatting syntax

Each token should be preceded with { and will be active until }. Note that {text} is also treated as valid token and will output text. Escaping with \ will print bracket(s) literally.

F<num> sets active font, <num> should be index of one of the elements from fonts list specified in --fonts=.

S<num>,<num>... specifies monitors to draw on. Multiple, comma separated, numbers can be specified. If not specified, draws to all available monitors. Negative number can be specified to set on which monitors to not draw.

CF0xAARRGGBB sets active foreground color.

CB0xAARRGGBB sets active background color.

AR aligns next text piece to the right.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL