https://github.com/pgaskin/barlib

A simple but flexible library for implementing efficient, fast, responsive, and error-tolerant i3status replacements in Go.
https://github.com/pgaskin/barlib

i3 i3bar i3status i3wm x11

Last synced: about 1 month ago
JSON representation

A simple but flexible library for implementing efficient, fast, responsive, and error-tolerant i3status replacements in Go.

• Host: GitHub
• URL: https://github.com/pgaskin/barlib
• Owner: pgaskin
• License: mit
• Created: 2024-03-29T14:08:27.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2024-05-12T10:45:52.000Z (8 months ago)
• Last Synced: 2024-05-12T20:28:45.340Z (8 months ago)
• Topics: i3, i3bar, i3status, i3wm, x11
• Language: Go
• Homepage:
• Size: 89.8 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
barlib




**A simple but flexible library for implementing efficient, fast, responsive, and

error-tolerant i3status replacements in Go.**

- Very flexible immediate-mode API.

- Per-module error handling and error recovery with proper cleanup.

- Multiple blocks per module with custom event handling.

- Memory/CPU efficency.

- Bar stop/continue handling.

- Aligned ticks across all modules with customizable global base tick rate (so the bar sleeps for as long as possible between updates).

- Update coalescing (so the bar updates all at once when multiple modules update at around the same time).

- Implements [i3bar protocol](https://i3wm.org/docs/i3bar-protocol.html) version 1 for i3 v4.3+.

- Unique sample module features not seen in other i3status implementations, like:

  - DDC-CI monitor brightness/contrast control.

  - Integrated display color temperature control.

  - Multi-state modules.

  - Battery charge limit display.

  - Extremely powerful mouse-driven media player control.

  - Automatic display layout presets.

- Highly optimized event-driven pure-go modules which react properly to external changes.

#### Usage

See [example_test.go](./example_test.go) for basic barlib usage, and [i3status-custom](./i3status-custom) for example modules I use myself.