FBCLI(1)

📦
version 0.8.9 · 8 versions
, in nixos 26.05, ubuntu resolute, ubuntu stonking

💖 fbcli — the manual page, section 1 💖

okay bestie, welcome to the fbcli glow-up guide. this is the little command-line bestie that talks to feedbackd and makes your machine go brrr with audio, visual, or haptic feedback. yes, haptics. we love a tactile moment. ✨

🌸 SYNOPSIS 🌸

fbcli [OPTIONS...]

that's it. that's the whole vibe. you just yeet some options at it. 🫶

🦋 DESCRIPTION 🦋

fbcli is literally here so you can submit events to feedbackd, which then triggers feedback for you — could be audio, could be visual, could be haptic. whatever the event's giving. it's giving feedback. 💅

✨ OPTIONS ✨

no cap, here's every single one. don't skip any, they all matter. 👑

  • -h, --help — prints the help text and then dips. that's it. iconic exit behaviour. 🌈
  • -E=EVENT, --event=EVENT — submits the event you name to feedbackd. the valid events are listed in the event naming spec, which lives right here: https://gitlab.freedesktop.org/agx/feedbackd/-/blob/main/doc/Event-naming-spec-0.0.0.md — go read it, iykyk. 📜
  • -I, --important — sets the important hint. yes or no. that's the whole thing. 🔥
  • -t=TIMEOUT, --timeout=TIMEOUT — the timeout, in seconds, after which the feedback for the given event should be stopped. so like, it vibes for exactly that long and then it's done. ⏳
  • -P=PROFILE, --profile=PROFILE — the feedback profile to use for the given event. the valid ones are full, quiet, and silent. important plot twist: if you don't specify an event, then the global feedback profile gets changed instead. so it's not just for one event, it's the whole mood. 🎚️
  • -w=TIMEOUT, --watch=TIMEOUT — the maximum timeout to wait for the feedback for the given event to end, and for fbcli itself to exit. so it's the "how long do we stand here watching" knob. 👀
  • -A=APP_ID, --app-id=APP_ID — overrides the application id that's being used. pretend to be someone else, respectfully. 🎭
  • -S=SOUND_FILE, --sound-file=SOUND_FILE — overrides the sound effect using the file you give it. heads up though: this only has an effect when a sound event would actually be triggered by this event at the current level. so if the current level wouldn't play a sound anyway, this does literally nothing. don't come for me, that's just the rules. 🔊

👑 See also 👑

and that's the whole page, bestie. 💜 no version or date drama on this one — the footer just signs off as fbcli(), so consider this your cute lil fbcli() sign-off. mwah. 🎀🦋💖

📦 where this page comes from