• notes
• .plan
• projects
• about
• contact

pista

Textual status bar with a simple, line-based protocol. Featuring:

• concurrent updates (asynchronously reads lines from N FIFOs and routes to corresponding N slots on the bar)
• cache invalidation (after a TTL without updates, a slot is cleared)
• easy to add custom feeds (just any process which continuously outputs lines)

QuickStart

dependencies

• build time
  • Rust (ideally from https://www.rust-lang.org/tools/install)
  • gcc
  • git
  • make
  • libc
  • libX11
• run time
  • tmux
  • libnotify (or libnotify-binon Debian, or whatever pkg has the notify-send binary)

pista repos

• pista: pista itself
• pista-feeds: data feeds
• pistactl: runs pista + feeds in a dedicated tmux session

$ cd "$WHERE_YOU_KEEP_CLONED_REPOS"
$ for repo in '
    https://github.com/xandkar/pista
    https://github.com/xandkar/pista-feeds
    https://github.com/xandkar/pistactl
'; do git clone "$repo"; done
$ for repo in pista pista-feeds pistactl; do \
    cd "$repo" && make && make install && cd ..; \
  done

configuration

• Shell's PATH: export PATH=$HOME/.cargo/bin/:/usr/local/bin:$PATH
• pistactl:
  1. copy example
  2. edit example
  3. add pistactl restart to ~/.xinitrc before exec dwm:

$ cp pistactl/examples/real/.pistactl.toml ~/
$ $EDITOR ~/.pistactl.toml
$ $EDITOR ~/.xinitrc

usage

$ pistactl --help

Notes

Deconflict the status area

Before starting pista, stop anything that maybe updating your dwm status and then clear the status area:

xsetroot -name ''

C

Any C99 compiler should do, but I only tested with:

• gcc
• ccomp

libc

• Debian: libc6-dev
• Void: glibc-devel

libX11

Check which of your system packages provides X11/Xlib.h, for example:

Debian

$ apt-file search X11/Xlib.h
ivtools-dev: /usr/include/IV-X11/Xlib.h
libghc-x11-dev: /usr/lib/haskell-packages/ghc/lib/x86_64-linux-ghc-8.4.4/X11-1.9-4LlBmptidprBzBXJCyaiH5/Graphics/X11/Xlib.hi
libhugs-x11-bundled: /usr/lib/hugs/packages/X11/Graphics/X11/Xlib.hs
libnx-x11-dev: /usr/include/x86_64-linux-gnu/nx-X11/Xlib.h
libx11-dev: /usr/include/X11/Xlib.h
python-pycparser: /usr/share/python-pycparser/fake_libc_include/X11/Xlib.h
python3-pycparser: /usr/share/python3-pycparser/fake_libc_include/X11/Xlib.h

to find libx11-dev

Void

$ xlocate X11/Xlib.h
bullet-devel-3.17_1        /usr/include/bullet/ThirdPartyLibs/optionalX11/X11/Xlib.h
libX11-devel-1.8.5_1       /usr/include/X11/Xlib.h
nx-libs-devel-3.5.99.26_2  /usr/include/nx-X11/Xlib.h

to find libX11-devel

git

• Debian: git
• Void: git