bar3x

command module
v0.3.6 Latest Latest
Warning

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

Go to latest
Published: Mar 5, 2021 License: GPL-3.0 Imports: 19 Imported by: 0

README

bar3x

image

bar3x is an easy to use and powerful status bar for your Linux desktop written in Golang. Linux status bars typically choose between highly customizable text and rich graphics. bar3x takes a slightly different approach by providing a simple markup language for its configuration that allows for :

  • Easy addition of new built-in modules
  • Rich external command modules
  • Customizable graphics

Installing

Download the latest release

Or, if you have the Golang toolchain installed :

go get github.com/ShimmerGlass/bar3x
Dependencies
  • libcairo : should already installed as it is used by GTK, otherwise:
    • Debian/Ubuntu: apt install libcairo2
    • Fedora: yum install cairo
    • Arch: pacman -S cairo

Quick Start

bar3x comes with a default configuration, and can be customized using bar3x -config config.yaml to change part or all of these parameters.

Find the list of available modules in the Wiki.

Here is an example config :


// colors configuration
bg_color:            "#17191e" // bar background
text_color:          "#d4e5f7" // general text
accent_color:        "#1ebce8" // icons and UI elements such as bars
neutral_color:       "#37393e" // background elements such as module separators and background graphs
neutral_light_color: "#90949d" // used for less important text such as units

// modules can be placed on the left, center and right of the bar
bar_left: |
  <ModuleRow> // choose the modules you want in each <ModuleRow>
    <Volume />
  </ModuleRow>

bar_center: |
  <ModuleRow>
    <DateTime />
  </ModuleRow>

bar_right: |
  <ModuleRow>
    <Interface Iface="enp3s0" />
    <CPU />
    <RAM />
    <DiskUsage MountPoint="/" />
  </ModuleRow>

Customizing

Much more that the colors can be customized, see this Wiki page on how to cutomize your bar.

Documentation

Overview

Example draw-text shows how to draw text to an xgraphics.Image type.

Directories

Path Synopsis
lib
cpu
ui
x

Jump to

Keyboard shortcuts

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