sddm/docs/THEMING.md

Themes

SDDM themes are created using QtQuick framework, a declarative framework to develop next-generation, hardware-accelerated user interfaces with fluid animations. QtQuick offers some basic components

On top of QtQuick, we provide some custom components to make theme development even easier. For example a picturebox which can show user avatars. Most of the components can be used as views in a model-view sense.

We also provide models containing information about the screens, sessions available and users. Connect these with the provided components and you have fully working solution. For example, below is the whole code needed to create a session selection combobox:

ComboBox {
	id: session
	arrowIcon: "angle-down.png"
	model: sessionModel
	index: sessionModel.lastIndex
}

Proxy Object

We provide a proxy object, called as sddm to the themes as a context property. This object holds some useful properties about the host system. It also acts as a proxy between the greeter and the daemon. All of the methods called on this object will transfered to the daemon through a local socket and will be executed there.

Properties

hostName: Holds the name of the host computer.

canPowerOff: true, if we can power off the machine; false, otherwise

canReboot: true, if we can reboot the machine; false, otherwise

canSuspend: true, if the machine supports suspending to the memory; false, otherwise

canHibernate: true, if the machine supports hibernating, e.g suspending to the disk; false, otherwise

canHybridSleep: true, if the machine supports hybrid sleep, e.g suspending to both memory and disk; false, otherwise

Methods

powerOff(): Powers of the machine.

reboot(): Reboots the machine.

suspend(): Suspends the machine to the memory.

hibernate(): Suspends the machine to the disk.

hybridSleep(): Suspends the machine both to the memory and the disk.

login(user, password, sessionIndex): Attempts to login as the user, using the password into the session pointed by the sessionIndex. Either the loginFailed or the loginSucceeded signal will be emitted depending on whether the operation is successfull or not.

Signals

loginFailed(): Emitted when a requested login operation fails.

loginSucceeded(): Emitted when a requested login operation succeeds.

Data Models

Besides the proxy object we offer a few models that can be hooked to the views to handle multiple screens or enable selection of users or sessions.

screenModel: This is a list model containing geometry information of the screens available. This model only provides logical screen numbers and geometries. If you have two physical monitors, but configured to be duplicates we only report one screen.

For each screen the model provides name and geometry properties. The model also provides, a primary property pointing to the index of the primary monitor and a geometry method which takes a monitor index and returns the geometry of it. If you -1 to the geometry method it will return the united geometry of all the screens avaiable.

sessionModel: This is a list model. Contains information about the desktop sessions installed on the system. This information is gathered by parsing the desktop files in the /usr/share/xsessions. These desktop files are generally installed when you install a desktop environment or a window manager.

For each session, the model provides file, name, exec and comment properties. Also there is a lastIndex property, pointing to the last session the user successfully logged in.

userModel: This is list model. Contains information about the users available on the system. This information is gathered by parsing the /etc/passwd file. To prevent system users polluting the user model we only show users with user ids greater than a certain threshold. This threshold is adjustable through the config file and called MinimumUid.

For each user the model provides name, realName, homeDir and icon properties. This model also has a lastIndex property holding the index of the last user successfully logged in, and a lastUser property containing the name of the last user successfully logged in.

Testing

You can test your themes using sddm-greeter. Note that in this mode, actions like shutdown, suspend or login will have no effect.

sddm-greeter --theme /path/to/you/theme