Scripts depending on this library will respect all of the following variables when set in the i3blocks config. Scripts that depend on this library will not run without it.

Life Pro Tip™®© : Set the colors globally in i3blocks for a coordinated theme.

• COLOR_HI : Color for active/high values. Default #aa652c
• COLOR_LO : Color for low/inactive values. Default #0085c0
• COLOR_ALT : Color for alternate states. Default #5c8225
• COLOR_ERR : Color for urgent/error states. Default #c14e79
• PREFIX : Text prepended to long output. Default None
• SUFFIX : Text appended to long output. Default None
• PREFIX_SHORT : Text prepended to short output. Default $PREFIX
• SUFFIX_SHORT : Text appended to short output. Default $SUFFIX

Displays GPU, Memory, and CPU utilization with pretty colors. Does NOT use bszi3b-shared.bash

• markup=pango set in i3blocks config
  • strongly recommend you also set interval=repeat and control speed using RATE
• bash + the gnu tools most sane distros have by default

• RATE : How long it measures utilization per output in seconds. Default 1.0

• THERMAL_FLOOR : All thermal text starts getting warmer above this value. Default 25 aka 77°F

• TEXT : Output plain text instead of colored html. Default false

• CPU : Enables CPU monitoring. Default true

• CPU_CLOCKS : Also display average CPU core clocks. Default false

• CPU_THERMALS : Also display CPU Tctl/Core max thermals. Defaultfalse

• CPU_THERMAL_CEIL : CPU thermal text is hottest at this value. Default 100

• MEM : Enables RAM monitoring. Default true

• GPU : Enables GPU monitoring. Default true

  • probably only works on AMD cards

• GPU_ID : Which card to monitor. Default 1

• GPU_CLOCKS : Also display GPU Core/Memory clocks. Default false

• GPU_THERMALS : Also display GPU Core/Junction/Memory thermals. Default false

  • Ceil taken directly from reported critical temperature

• GPU_POWER : Also display GPU power in watts. Default false

• SEPARATOR : Separator between categories on long output. Default ][

• SEPARATOR_SHORT : Separator between categories on short output. Default

• SEPARATOR_THERMAL : Separator before thermal values. Default °

• SEPARATOR_POWER : Separator before power value. Default ⌁

• PREFIX : Text prepended to long output. Default [

• SUFFIX : Text appended to long output. Default ]

• PREFIX_SHORT : Text prepended to short output. Default None

• SUFFIX_SHORT : Text appended to short output. Default None

Simple widget for toggling anything

• bszi3b-shared.bash

• CMD_STATUS : Command run to query status. Required
• RE_STATUS : Regular expression to determine status state. Required
• CMD_ON : Command to run when left clicked. Optional
• CMD_OFF : Command to run when right clicked. Optional

• LMB : Run CMD_ON
• RMB : Run CMD_OFF

[bsz/toggler]
interval=5
PREFIX=OMPL Status: 
CMD_STATUS=ompl print playing
RE_STATUS=true
CMD_ON=ompl play
CMD_OFF=ompl stop

Displays and controls volume for WirePlumber

• bszi3b-shared.bash

• Scroll Up : Increase volume
• Scroll Down : Decrease volume
• LMB : Toggle mute
• RMB : Reset volume to 1.0

• DEVICE : Device ID to use. Default @DEFAULT_AUDIO_SINK@

• PREFIX : Prefix applied to all icons. Default none. Handy for running a 2nd time for source

• ICON_LO ICON_MID ICON_HI ICON_MUTE : icons to display for different Volume levels. Defaults...

  • ICON_LO : "< "
  • ICON_MID : "<l "
  • ICON_HI : "<ll "
  • ICON_MUTE : "<X "

Displays a given tagstring with playback controls for the OMPL music player

• bszi3b-shared.bash
• OMPL

• LMB : Play/pause
• RMB: Stop
• Scroll Up: Next track
• Scroll Down: Previous track

• TAGSTRING : Long tagstring display. Defaults to OMPL's statusline if unset

• TAGSTRING_SHORT : Short tagstring display. Default title

• VOL_SIGNAL : If set to a signal number, will trigger the appropriate i3blocks widget every iteration. Intended for ompl-volume.

• ICON_PAUSE ICON_PLAY ICON_STOP : icons to display for different player states. All default to ""

Displays and controls volume for the OMPL music player

If using with ompl-status, recommended you set interval=0 and use VOL_SIGNAL to reset the widget instead.

• bszi3b-shared.bash
• OMPL

• LMB/Scroll Up : Increase volume
• RMB/Scroll Down : Decrease volume

• ICON_LO ICON_MID ICON_HI : icons to display for different Volume levels. Defaults...
  • ICON_LO : "< "
  • ICON_MID : "<l "
  • ICON_HI : "<ll "

Displays GPU utilization, hardware video decoder utilization, and memory usage.

Archived because I no longer have an nvidia gpu.

• GNU bash
• nvidia-smi

• GPU_ID : Which GPU to fetch stats from. Default 0
• SEPARATOR : Separates different fields in long display. Default |
• COLOR_IDLE : Hex code for color displayed when GPU is idle. Default #2EAFFF
• COLOR_ERROR : Hex code for error message color. Default #FF898E

Simple widget for EasyEffects global bypass

Archived in favor of using toggler directly

• COLOR_ON : Color when on (no bypass)
• COLOR_OFF : Color when off (bypass enabled)
• COLOR_ERROR : Color if anything else happens

• LMB : Turn on (disable bypass)
• RMB : Turn off (enable bypass)