beastie/README
daemon 2827a5b7ad update README example output and wm detection note
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-16 05:26:28 -05:00

59 lines
1.8 KiB
Text

beastie - minimal system fetch
================================
Minimal system info tool for BSD. Displays info side-by-side with
ASCII art. Named after the BSD daemon mascot.
Reads hardware/OS info via sysctlbyname(3).
WM detection uses xprop(1) at runtime if MOD_WM is enabled.
EXAMPLE OUTPUT
--------------
%@ realdaemon@daemon-box
%# @##
%#@ @%%%%%%@%%##@ os FreeBSD 15.0
@%%##@%%%%%@######%## kernel MinKern
%%%###%%%%# @@ @# cpu Intel(R) Core(TM) i7-4910MQ
%%%%%%%%## @ @#@ uptime 2h 21m
@%%%%%## @@#@@# mem 2086M / 16237M
%%%%#### @@##### shell sh
%%%%%%#####%##@## *: term st
@%%%#@######%#@ : :@ wm dwm
%%%%%%###@ @# @:@ @: disk 5.3G / 890.0G
%%###### %#@ pkgs 541 (pkg)
@%%@##@###@%%##@ res 1920x1080
%%%##%####@%@@
@%%%%%%%%%@
@%@::%@@%##@
@%:@%%%####@
@%%%@@%@:@%:#
@%%%%%@ @+ :-:@@:::@@@
%##@@ %::::::# . @
%%@ %@ @ @
@@%####
CONFIGURATION
-------------
Edit config.h and recompile. Configurable:
COLOR_ART ANSI color for the ASCII art
COLOR_USER ANSI color for the user@host header
COLOR_LABEL ANSI color for info labels
ART_W Visual width of the widest art line (must be accurate)
ART[] The ASCII art, one line per string
BUILD AND INSTALL
-----------------
make
doas make install
Installs to /usr/local/bin/beastie. Override PREFIX to change.
REQUIREMENTS
------------
BSD: base system, optionally xdpyinfo(1) for wm vendor detection