byobu-select-session(1)

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

✨ NAME ✨

okay so this is byobu-select-session(1) from the byobu manual (section 1, bestie) — and it does exactly one iconic thing: it helps you select and connect to a byobu session. that's the whole vibe. 💅

🌸 DESCRIPTION 🌸

so byobu-select-session is this little app that lists all the available screen sessions running on your system, and then it prompts you to pick one. like a menu but for your sessions. 🎀

and it's not even just "pick one" — you also get the option to:

  • create a brand new Byobu session ✨
  • or just launch the default shell without Byobu at all 🙈
ngl, if you pick an invalid selection 3 times in a row, you get yeeted into the youngest session. that's the rule. no escaping it 💀

the default behavior, fr fr:

by default, if there's only one session existing, you just get connected straight to it. and if no sessions exist, a new session gets created — so normally there's no interactive prompt at all. it just does the thing. slay.

but some users are like "no, i want to be asked, every single time" and for that, you touch the file:

$BYOBU_CONFIG_DIR/.always-select

and boom, you're always prompted. 💖

📌 note that BYOBU_CONFIG_DIR=$HOME/.byobu.

the hidden session lore 🫶:

named sessions that start with a "." are "hidden" from byobu-select-session(1). so nobody auto-selects them, nobody sees them in the list. super useful if, for instance, you do not want a session to be automatically selected at login. sneaky. main character energy.

example, bestie:

byobu -S .hidden

🎀 FILES 🎀

  • $BYOBU_CONFIG_DIR/.always-select

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

this manpage and the utility were written by Dustin Kirkland <kirkland@byobu.org> for Ubuntu systems (but like, may be used by others too, we don't gatekeep 💜).

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:

and that's the whole page, bestie!! this came from the byobu manual, dated 12 Jan 2010 — old but absolutely still eating 💅✨ go pick a session, you got this 🫶🌸

📦 where this page comes from