https://github.com/acuteenvy/shstatus

A simple statusline generator for i3bar and swaybar
https://github.com/acuteenvy/shstatus

bash i3 i3wm sway swaybar swaywm

Last synced: 4 months ago
JSON representation

A simple statusline generator for i3bar and swaybar

• Host: GitHub
• URL: https://github.com/acuteenvy/shstatus
• Owner: acuteenvy
• License: mit
• Created: 2023-03-19T21:07:21.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-02T18:45:43.000Z (about 1 year ago)
• Last Synced: 2025-04-02T19:38:21.783Z (about 1 year ago)
• Topics: bash, i3, i3wm, sway, swaybar, swaywm
• Language: Shell
• Homepage: https://acuteenvy.github.io/shstatus/
• Size: 93.8 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# shstatus

[![CI](https://github.com/acuteenvy/shstatus/actions/workflows/ci.yml/badge.svg)](https://github.com/acuteenvy/shstatus/actions/workflows/ci.yml)

[![release](https://img.shields.io/github/v/release/acuteenvy/shstatus?display_name=tag&color=violet)][latest-release]

[![license](https://img.shields.io/github/license/acuteenvy/shstatus?color=blueviolet)](/LICENSE)

`shstatus` is a shell script that generates statuslines for bars that support the [i3bar protocol](https://i3wm.org/docs/i3bar-protocol.html).

![screenshot](https://user-images.githubusercontent.com/126529524/227034687-5aaa6581-9fb9-4f7d-a92c-2228368b479a.png)

## Installation

Download [the latest release][latest-release].

```

$ tar xf shstatus*

$ cd shstatus-VERSION

# make install

```

An [AUR package](https://aur.archlinux.org/packages/shstatus) is also available.

## Configuration

See `man shstatus` or the [online manpage](https://acuteenvy.github.io/shstatus).


There is [an example config file](/config.sh) in this repository.

It'll be installed to `/etc/shstatus/config.sh` when you run `make install`.

[latest-release]: https://github.com/acuteenvy/shstatus/releases/latest