STAG(1)

📦 version 1.0.0, in nixos 26.05, nixpkgs unstable

✨ STAG(1) ✨

okay so welcome to the Stag Manual for stag — aka STAG(1) — and it's literally streaming graphs with ncurses 💅. ngl, this page ate and left no crumbs, and your bestie is gonna walk you through it, no cap.

🎀 NAME 🎀

stag — streaming graphs with ncurses. that's the name, that's the vibe, periodt 🦋.

🌈 SYNOPSIS 🌈

stag [-t TITLE] [-m MARGIN] [-s SCALE_MODE] [-w BAR_WIDTH] [-y Y_SPLITS]

💖 DESCRIPTION 💖

okay so stag generates a streaming bar graph of the data (line separated floats) passed through stdin. yes bestie, line separated floats through stdin — it's giving data pipeline main character energy, highkey ✨.

🍓 OPTIONS 🍓

  • -t, --title=TITLE — Set the title displayed above the graph. cute little nameplate energy 🎀.
  • -m, --margin=T,R,B,L — Set the margin around the edge of the graph, defined as a comma delimited list of 4 integers: top,right,bottom,left. not me obsessing over the order, but it's top,right,bottom,left 💅.
  • -s, --scale=SCALE_MODE — Choose how to scale the y-axis of the graph. the way that this gives you options? iconic. the modes are:
    • dynamic: update the max using the values currently on the graph.
    • global: update the max to be the global maximum of all data seen.
    • min,max: specify the max and min using two integers.
  • -w, --width=BAR_WIDTH — Set the width of the bars. chunky bars? slim bars? your call, bestie 🫶.
  • -y, --split=Y_SPLITS — Set the number of intermediate y-axis ticks between the min and max. y-axis tick moment, fr fr ✨.

🧚 EXAMPLES 🧚

Trivial example:

echo -e "1\n2\n3" | ./stag

See examples/ directory for more. vibe check: passed 👑

👑 AUTHOR 👑

Seena Burns (hello@seenaburns.com)

View on https://github.com/seenaburns/stag

💜 and that's the whole manual, bestie — this is Stag 1.0, dated August 26, 2014, and you just read STAG(1). slay, go make some streaming bar graphs 🌈💖

📦 where this page comes from