byobu-ugraph(1)

📦
version 7.20 · 2 versions
, in nixpkgs unstable, ubuntu stonking

💖 byobu-ugraph — the girlies' guide to history graphs 💖

okay so bestie, this is byobu-ugraph from the byobu manual. it's a little helper script, and it's genuinely so useful, no cap. let's get into it 🫶

✨ NAME ✨

byobu-ugraph — a helper script for notification history graphs 💅

🌸 DESCRIPTION 🌸

byobu-ugraph is a helper script that can be used to create history graphs. that's the whole vibe fr fr — it makes graphs, it's helpful, it's giving background-support-character-that-ate. ✨

🎀 USAGE 🎀

here's the shape of it:

byobu-ugraph [options] [command [args...]]

yep, options first, then optionally a command with its little args trailing behind it. 🦋

👑 OPTIONS 👑

one bullet per option, all of them, no skipping, we don't do that here:

  • -f <file> — the file to read data points from. (only required if no command specified).
  • -h — show this help. your lil rescue flag 🫶
  • -m <num> — minimum value (default=$min_default).
  • -n — suppress output of the newline character. quiet lil queen 🙈
  • -p <points> — specify the number of data points in the graph (default=$points_default).
  • -r — do not rotate file <file> (the default behaviour is to rotate). heads up: this option implies file <file> should not be written to, so a command cannot follow the script options in this case. periodt.
  • -t <theme> — the 'byobu-ulevel' theme to use (default=$theme_default). serve looks 💅
  • -x <num> — maximum value (default=$max_default).

🌈 EXAMPLES 🌈

using byobu-ugraph to run a command, rotate log and display graph

so here we specify a command to display available memory. the trailing echo adds a required newline. note: no filename specified. 👀

byobu-ugraph "(/usr/lib/byobu/mem_used | sed -e 's/% //g';echo)"

using byobu-ugraph just to rotate log and display the graph

file=/tmp/load.dat
awk '{ print $1}' /proc/loadavg >> $file
# Note: we need to specify what we consider to be a "reasonable" maximum load
byobu-ugraph -m 3.0 -f $file

iconic. that's the load graph, bestie 🍓

🧚 NOTES 🧚

if you specify 'command', care must be taken with shell quoting to avoid expansion prior to this script running the command. fr fr, the shell will do shell things if you don't quote it right 😭
if '-r' is not specified, the file <file> will be rotated such that at most <points> lines are retained on each invocation of this script. important!! 💀

💜 SEE ALSO 💜

🌟 AUTHOR 🌟

this utility was written by James Hunt <james.hunt@canonical.com>, and this manpage was written by Dustin Kirkland <kirkland@byobu.org> for Ubuntu systems (but may be used by others). permission is granted to copy, distribute and/or modify this document and the utility under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL on Debian/Ubuntu systems, or in /usr/share/doc/fedora-release-*/GPL on Fedora systems, or on the web at http://www.gnu.org/licenses/gpl.txt 🌈

and that's the whole thing bestie!! 💖 this page is from the byobu manual, and it's dated 16 Dec 2013 — yeah she's an elder but she ATE and she's still slaying. mwah, go make some graphs 🎀✨👑

📦 where this page comes from