https://github.com/distatus/gobar

minimalistic X status bar in pure Go
https://github.com/distatus/gobar

go statusbar x11

Last synced: 29 days ago
JSON representation

minimalistic X status bar in pure Go

• Host: GitHub
• URL: https://github.com/distatus/gobar
• Owner: distatus
• License: other
• Created: 2014-07-06T18:58:05.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-01-27T18:56:22.000Z (almost 2 years ago)
• Last Synced: 2024-08-03T23:29:05.774Z (4 months ago)
• Topics: go, statusbar, x11
• Language: Go
• Homepage:
• Size: 60.5 KB
• Stars: 68
• Watchers: 5
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-golang-repositories - gobar

README

        
[![Build Status](https://github.com/distatus/gobar/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/distatus/gobar/actions/workflows/tests.yml)

**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, both fed by [osop](https://github.com/distatus/osop).

For detailed configuration see [my](https://github.com/KenjiTakahashi/dotfiles/blob/master/dotxprofile) [dotfiles](https://github.com/KenjiTakahashi/dotfiles/tree/master/dotconfig/osop).

![screenshot](http://img.kenji.sx/gobar_dual.png)

## installation

First, you have to [get Go](http://golang.org/doc/install). Note that version >= 1.1 is required.

Then, just

```bash

$ go get github.com/distatus/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 *(defaults to false)*.

**--geometries** takes comma separated list of monitor geometries *(defaults to `0x16+0+0`)*.

Each geometry is in form of `x++`. If ``/`` is `0`, screen width/height is used.

If geometry is empty, bar is not drawn on a respective monitor.

If there are less geometries than monitors, last geometry is used for subsequent monitors.

**--fonts** takes comma separated list of fonts.

Each font element is in form of `[:]`.

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

If nothing suitable is found, falls back to `Liberation Mono` that is always bundled with the Go font library.

If `` part is omitted or incorrect, defaults to `12`.

**--fg** takes main foreground color. Should be in form `0xAARRGGBB` *(defaults to `0xFFFFFFFF`)*.

**--bg** takes main background color. Should be in form `0xAARRGGBB` *(defaults to `0xFF000000`)*.

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

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

```bash

$ 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.