UKUI-SESSION(1)

📦 version 4.20.0.2, in ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 UKUI-SESSION(1) — the General Commands Manual glow-up 💖

okay bestie, so this is the manual page for ukui-session, from the General Commands Manual, and it's literally the thing that boots your whole UKUI desktop. let's get into it 🫶

✨ NAME ✨

ukui-session — Start the UKUI Desktop Environment. that's it, that's the job, and she does it flawlessly 💅

🌸 SYNOPSIS 🌸

ukui-session [OPTIONS]

🦋 DESCRIPTION 🦋

so the ukui-session program is what starts up the UKUI desktop environment. no cap, that's her whole main character moment.

normally you don't run this yourself — it gets executed by your Login/Display Manager (like GDM, LXDM, XDM, SLiM, or from your X startup scripts like .xinitrc). she's the popular girl everyone calls first. 💖

when she starts, she'll either load up your saved session, or she'll hand you a default session — whichever the system administrator defined (or whatever the default UKUI installation on your system ships with).

the default session lives in the dconf keys under

/org/ukui/desktop/session/

and when a session gets saved, ukui-session writes the currently running applications into the ~/.config/ukui-session/saved-session directory inside the user's /home. iconic behavior honestly 🎀

also, ukui-session is an X11 session manager. she can manage UKUI applications and any other X11 SM compliant ones too. versatile queen 👑

⭐ OPTIONS ⭐

The following options are supported:

  • -a, --autostart=DIR — start all the applications defined in DIR, instead of starting the applications defined in /org/ukui/desktop/session/default-session. and yes bestie, you can pass multiple --autostart options. stack 'em. slay. 🔥
  • -f, --failsafe — run in fail-safe mode. user-specified applications will not be started. it's giving "we're keeping this simple, no extras." 🧚
  • --debug — enable debugging code. the tea-spilling mode fr fr 🍓
  • --display=DISPLAY — the X display to use.
  • --version — output version information and exit. quick little peek, then she's out 💨
  • -?, -h, --help — print standard command line options.
  • --help-all — print all the command line options. the full lore drop 📖

🌈 ENVIRONMENT 🌈

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

  • SESSION_MANAGER

this variable is what session-manager aware clients use to contact ukui-session. it's basically her phone number 📱

  • DISPLAY

this one gets set to the X display that ukui-session is using. ⚠️ but heads up bestie: if the --display option is used, this might be different from the setting of the environment variable back when ukui-session was invoked. keep an eye on that one 👀

🎀 FILES 🎀

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

the applications defined in those directories up there will be started on login. and if you want to configure them the easy way, ukui-session-properties(1) is right there for you. she makes it effortless 💅

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

this directory contains the list of applications of the saved session. your little time capsule of what was open 🫶

💀 BUGS 💀

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

https://github.com/ukui/ukui-session-manager/issues

ngl if something's broken, go tell them. they wanna know 🙈

👑 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)

the lineage?? immaculate. generations of legends fr fr 🌟

🔥 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, every last crumb of it 💜

this one came from the <strong>UKUI Desktop Environment</strong>, dated <strong>11 February 2023</strong>, and it's filed as <strong>UKUI-SESSION(1)</strong> — go forth and boot your desktop, you absolute icon 🎀✨

📦 where this page comes from