bunsenlabs-session.1

.TH "BUNSENLABS-SESSION" "1"
.SH "NAME"
bunsenlabs-session \(em Starts a BunsenLabs session.

.SH "DESCRIPTION"
.PP
\fBbunsenlabs-session\fR runs a BunsenLabs session, calling a window manager
and starting the necessary auxiliary applications.
There is no full session manager, so you will not be able
to save your state from one log in to the next.
Although openbox is the default BunsenLabs window manager,
users can select others while continuing to use the BunsenLabs
menu, keyboard shortcuts and autostarted applications (see below).
.PP
\fBbunsenlabs-session\fR does not take any command line
arguments.
.PP
\fBbunsenlabs-session\fR is set as the Debian alternative "x-session-manager"
so it will be run by default in a Debian X session, and a .desktop file
is installed to /usr/share/xsessions so it can be started by a display manager like LightDM.
.PP
On log in, \fBbunsenlabs-session\fR will run the
~/.config/bunsen/autostart script if it exists, and will copy in the
default file from /usr/share/bunsen/skel/.config/bunsen/autostart otherwise. You may
place anything you want to run automatically in this file, for example:

.PP
.RS
.PP
.nf
xset -b off
xfce4-clipman &
.fi
.RE
.PP
Make sure that each command that does not return quickly is followed by a "&" or else the script will
stop there and further commands will not be executed. You can use the
/usr/share/bunsen/skel/.config/bunsen/autostart file as an example for creating your
own.
.PP
.SS "Window Manager:"
Users can choose another window manager than the
default openbox by editing the line:

.PP
.RS
.PP
.nf
window_manager=openbox
.fi
.RE
.PP
near the top of ~/.config/bunsen/autostart. In such cases they will
probably want to adjust the autostarted applications, likely with a
new "case" clause for the new window manager. (See autostart for examples.)

.SH "AUTHORS"
Written by the BunsenLabs team
.SH "REPORTING BUGS"
Please report bugs at:
.IP
https://github.com/BunsenLabs/configs/issues
.SH "SEE ALSO"
\fBbl-user-setup(1), bl-xdg-autostart(1), openbox(1), openbox-session(1), jgmenu(1), xbindkeys(1), xsession(5).\fR
.\" written by John Crawley, Tue 18 June 2019, 17:30