Skip to content

Using the desktop

The desktop is DEsk on Wayland: one wlroots compositor that is the whole desktop. Windows are sheets of paper on a desk, programs sit in a bookcase, notifications arrive as letters in a post box, and the screen locks at a front door. It is built in the [runink] repository from DEsk’s release plus the Runink fork’s patches (runink-desk). Nothing in the session is Python; the few jobs DEsk would hand to a Python program are done by small Go helpers instead.

Signing in

greetd shows the login screen, gtkgreet in the cage compositor, on the dark Runink River wallpaper. Sign in with the account the installer created. The same password unlocks your keyring: the login screen’s PAM stack (/etc/pam.d/greetd) includes pam_gnome_keyring, so programs that keep passwords in the GNOME keyring (Wi-Fi passphrases from the network applet, for example) do not ask again.

The programs

JobProgram
Terminalfoot
FilesThunar (with gvfs and udisks2)
TextMousepad
WebFirefox (telemetry and studies off by system policy)
Pictures, PDF, archives, music and videoRistretto, Atril, Engrampa, Parole
Displayswdisplays
ScreenshotsPrint and Alt+Print (desk-screenshot, with grim); a letter says where the picture went

Common tasks

Connect to a network

The network applet in the tray (nm-applet) handles wired, Wi-Fi and VPN connections, and nm-connection-editor edits them. From a terminal, nmcli and nmtui do the same: Networking.

Memory sticks and external disks

A memory stick or disk that udisks2 marks for automounting is mounted for you as you put it in, and any that are already in when you sign in. Each mount arrives as a letter in the post box. This is river-desk automount, started at login from /etc/xdg/autostart/river-automount.desktop.

Battery

On a laptop, river-desk battery sends a letter when a discharging battery falls to 15 %, and again at 5 %.

Bluetooth

Shell Settings’ Bluetooth row (and DEsk’s Bluetooth lever) opens Bluetooth, river-bluetooth: bluetuith, a terminal program for finding, pairing and connecting devices, in a foot window. bluetoothctl works too. The bluetoothd service runs under s6.

Printers

Shell Settings’ Printers row opens Printers, river-printers: CUPS’s own pages at http://localhost:631/ in your browser, where you add and manage printers. cupsd runs under s6. Printers on your LAN are found over mDNS, which the firewall lets in.

Keyboard layout and language

See Keyboard & language.

Under the hood

The session runs on s6 through elogind and dbus, not systemd: s6 init. The helpers are one Go program, river-desk (installer/desk/, standard library only), shipped in runink-installer; it starts only the programs it names (foot, xdg-open, udisksctl, gdbus, notify-send). The design record for the move to DEsk is docs/DESKTOP-DESK-PLAN.md.