UKUI-SESSION(1)

📦
version 4.20.0.2 · 2 versions
, in debian bookworm, ubuntu jammy, ubuntu resolute, ubuntu stonking

💖 UKUI-SESSION 💖

okay bestie, this is a General Commands Manual page, and we're about to make starting a whole desktop environment feel like the most main character thing ever. no cap. ✨

🌸 NAME 🌸

ukui-session — Start the UKUI Desktop Environment. that's it, that's the vibe. 💅

🦋 SYNOPSIS 🦋

ukui-session [OPTIONS]

✨ DESCRIPTION ✨

so the ukui-session program literally starts up the UKUI desktop environment. iconic behavior honestly. 👑

this command is typically executed by your Login/Display Manager (like GDM, LXDM, XDM, SLiM, or from your X startup scripts like .xinitrc). she doesn't just show up on her own — somebody has to invite her.

she will load either your saved session, or she'll provide a default session for the user as defined by the system administrator (or the default UKUI installation on your system). either way, you're getting a session. periodt.

the default session is defined in the dconf keys under

/org/ukui/desktop/session/

when saving a session, ukui-session saves the currently running applications in the ~/.config/ukui-session/saved-session directory of the users /home. yes, she's keeping receipts. 📝

ukui-session is an X11 session manager. she can manage UKUI applications as well as any other X11 SM compliant ones. so she's not gatekeeping — she plays nice with everyone. 🫶

🎀 OPTIONS 🎀

the following options are supported:

  • -a, --autostart=DIR — start all applications defined in "DIR", instead of starting the applications defined in /org/ukui/desktop/session/default-session. and the bestie part? multiple --autostart options can be passed. stack 'em. 🔥
  • -f, --failsafe — run in fail-safe mode. user-specified applications will not be started. it's giving "we're keeping it minimal today." 🙈
  • --debug — enable debugging code. for when you need to see everything. 👀
  • --display=DISPLAY — X display to use.
  • --version — output version information and exit.
  • -?, -h, --help — print standard command line options.
  • --help-all — print all command line options.

🌈 ENVIRONMENT 🌈

ukui-session sets several environment variables for the use of its child processes:

  • SESSION_MANAGER

this variable is used by session-manager aware clients to contact ukui-session. it's basically her phone number. ☎️

  • DISPLAY

this variable is set to the X display being used by ukui-session. note that if the --display option is used this might be different from the setting of the environment variable when ukui-session is invoked. so like, don't be shocked if the receipts don't match, iykyk. 💀

🍓 FILES 🍓

  • ~/.config/autostart
  • /usr/share/autostart
  • /usr/share/ukui/autostart

the applications defined in the above directories will be started on login. ukui-session-properties(1) can be used to easily configure them. lowkey the easiest glow-up in this whole manpage. ✨

  • ~/.config/ukui-session/saved-session

this directory contains the list of applications of the saved session.

💀 BUGS 💀

should you encounter any bugs, they may be reported at:

https://github.com/ukui/ukui-session-manager/issues
no gatekeeping on bugs bestie, go tell them. 🙈

👑 AUTHORS 👑

this Manual page was originally written for gnome-session by:

  • Miguel de Icaza <miguel@helixcode.com> (2000)
  • Vincent Untz <vuntz@gnome.org> (2009-2010)

it has been updated for the MATE Desktop Environment by:

  • Adam Erdman <hekel@archlinux.info> (2014)

it has been updated for the UKUI Desktop Environment by:

  • yilei <yilei@kylinos.cn> (2016)

🔥 SEE ALSO 🔥

further information may also be available at: http://wiki.ukui.org/

  • ukui-session-properties(1), ukui-session-save(1), ukui-wm(1)

and that's the whole page bestie!! this one came from the UKUI Desktop Environment, dated 11 February 2016, and it's filed under UKUI-SESSION(1). go start that desktop, you absolute icon. 🦋💜🌸

📦 where this page comes from