budgie-session(1) | General Commands Manual | budgie-session(1) |
budgie-session - Start the budgie desktop environment
budgie-session [-a|--autostart=DIR] [--session=SESSION] [--failsafe|-f] [--debug] [--whale]
The budgie-session program starts up the budgie desktop environment. This command is typically executed by your login manager (either gdm, xdm, or from your X startup scripts). It will load either your saved session, or the default budgie installation on your system. Note that budgie-session is a wrapper script for budgie-session-binary.
$XDG_CONFIG_HOME/budgie-session/sessions, $XDG_CONFIG_DIRS/budgie-session/sessions and $XDG_DATA_DIRS/budgie-session/sessions.
When saving a session, budgie-session saves the currently running applications in the $XDG_CONFIG_HOME/budgie-session/saved-session directory. Saving sessions is only supported with the legacy non-systemd startup method.
budgie-session is an X11R6 session manager. It can manage budgie applications as well as any X11R6 SM compliant application.
The following options are supported:
Sessions are defined in .session files, that are using a .desktop-like format, with the following keys in the budgie Session group:
Here is an example of a session definition:
[budgie Session] Name=budgie RequiredComponents=budgie-desktop;gnome-settings-daemon;
The .session files are looked for in $XDG_CONFIG_HOME/budgie-session/sessions, $XDG_CONFIG_DIRS/budgie-session/sessions and $XDG_DATA_DIRS/budgie-session/sessions.
It is best to use --builtin if session customizations are required. This is due to the way that budgie currently defines the components that will be started on each session type.
budgie-session sets several environment variables for the use of its child processes:
SESSION_MANAGER
DISPLAY
Behavior of budgie-session ifself can be modified via the following environment variable:
GNOME_SESSION_AUTOSTART_DIR
$XDG_CONFIG_HOME/autostart $XDG_CONFIG_DIRS/autostart /usr/share/gnome/autostart
$XDG_CONFIG_HOME/budgie-session/sessions $XDG_CONFIG_DIRS/budgie-session/sessions $XDG_DATA_DIRS/budgie-session/sessions
$XDG_CONFIG_HOME/budgie-session/saved-session
If you find bugs in the budgie-session program, please report these on https://github.com/buddiesofbudgie/budgie-session/issues.
budgie-session-quit(1)
Oct 2023 | BUDGIE |