CBATTICON(1)

📦
version 1.6.13 · 2 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

🦋 cbatticon(1) — the user manual, but make it cute

okay so bestie, welcome to cbatticon 💖 it's a lightweight and fast battery icon that literally just sits in your system tray, living its main character life, and tells you what your battery is doing. no cap.

✨ SYNOPSIS ✨

cbatticon [option] [battery id]

🎀 DESCRIPTION 🎀

so the cbatticon utility shows you battery info — think battery status, remaining percentage, and remaining time — using a little icon chilling in your system tray 🫶 that's the whole vibe.

if you don't specify a battery id, it'll just go ahead and display the first battery that is found. icon behavior fr fr.

and if you wanna know which batteries you even have? just hit it with the --list-power-supplies option 👑 easy.

💅 OPTIONS 💅

  • -c, --command-critical-level command — tell it which command to run when the battery hits the critical level. dramatic much? valid tho 💀
  • -d, --debug — display debug information. for the girlies who need to see everything 🔍
  • -h, --help — show help information and exit. the "wait what does this do again" button 🙈
  • -i, --icon-type type — pick the icon type to display in the system tray. if you don't specify one, cbatticon will use the first one that is available in this sequence: standard, notification, symbolic ✨ and psst — you can list the available icon types on your system with --list-icon-types.
  • -l, --low-level percentage — set the low level percentage of the battery. the default is 20% 🌸
  • -n, --hide-notification — hide the notification popups. sometimes you just want peace and quiet, iykyk 🧚
  • -o, --command-low-level command — specify the command to execute when the low battery level is reached 🎀
  • -p, --list-power-supplies — list the available power supplies on your system. literally your battery inventory 🔥
  • -r, --critical-level percentage — set the critical level percentage of the battery. the default is 5% ⭐
  • -t, --list-icon-types — list the available icon types (standard, notification, symbolic). so iconic 👑
  • -u, --update-interval interval — set the number of seconds between updates of the battery information. the default is 5 seconds ⏰
  • -v, --version — display the version information and exit 💜
  • -x, --command-left-click command — specify the command to execute when you left click on the tray icon. yes, click commands, we love a multitasker 🖱️💖

🌈 EXAMPLES 🌈

just the vibes, run as-is:

cbatticon
cbatticon -t
cbatticon -p
cbatticon -u 20 -i notification -c "poweroff" -l 15 -r 3
okay real talk bestie — that last one sets the update interval to 20, the icon type to notification, the critical-level command to "poweroff", the low level to 15, and the critical level to 3. which means if your battery gets low, poweroff is gonna happen. so like… know what you're doing, fr fr 😭💀

okay that's the whole page 🌸 this manual is from the User manual, source cbatticon, dated June 11, 2019, and its manual name is CBATTICON(1) — mwah, hope your battery stays at 100% forever 🎀💖✨🫶

📦 where this page comes from