Man pages sections > man1 > byobu-select-session

byobu-select-session - select and connect to a byobu session

byobu-select-session(1) byobu byobu-select-session(1)

NAME

byobu-select-session - select and connect to a byobu session
 

DESCRIPTION

byobu-select-session is an application that lists the available screen sessions running on the system, and prompts the user to select one. The user also has the option to create a new Byobu session, or launch the default shell without Byobu.
 
If an invalid selection is chosen 3 times in a row, the user is connected to the youngest session.
 
By default, if only one session exists, the user is connected to that session, and if no sessions exist, a new session is created -- such that there is no interactive prompt in the normal behavior. However, some users may choose to always be prompted, by touching the file $BYOBU_CONFIG_DIR/.always-select.
 
Note that BYOBU_CONFIG_DIR=$HOME/.byobu.
 
Named sessions that begin with a "." are "hidden" from byobu-select-session(1). This is useful, for instance, if you do not want a session to be automatically selected at login. Example:
byobu -S .hidden
 

FILES

$BYOBU_CONFIG_DIR/.always-select
 

SEE ALSO

byobu(1), screen(1)
 
http://byobu.org
 

AUTHOR

This manpage and the utility were 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.
12 Jan 2010 byobu