SDDM: Difference between revisions

From Alpine Linux
m (→‎See also: category fix)
(add wayland category)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
SDDM, or ''Simple Desktop Display Manager'', is a display manager for [[X11]] and [[Wayland]] aiming to be fast, simple and beautiful. It is the recommended [[Display Manager|display manager]] for the [[KDE|KDE Plasma]] and [[LXQt]] desktop environments.
SDDM, or ''Simple Desktop Display Manager'', is a display manager for [[X11]] and [[Wayland]] aiming to be fast, simple and beautiful. It is the recommended [[:Category:Display Managers|display manager]] for the [[KDE|KDE Plasma]] and [[LXQt]] desktop environments.


This page outlines the basic installation of SDDM, as well as some configuration options.
This page outlines the basic installation of SDDM, as well as some configuration options.
Line 7: Line 7:
Begin by installing the {{Pkg|sddm}} package:
Begin by installing the {{Pkg|sddm}} package:


{{Cmd|# apk add sddm}}
{{Cmd|# apk add sddm {{pkg|xorg-server-xephyr}}}}


Test the service to see if it launches and works, then enable the service to launch at boot:
Test the service to see if it launches and works, then enable the service to launch at boot:
Line 25: Line 25:
=== Themes ===
=== Themes ===


Themes for SDDM are located in <code>/usr/share/sddm/themes/</code>.
Themes for SDDM are located in {{Path|/usr/share/sddm/themes/}}.


Users can set the theme in <code>/etc/sddm.conf</code>
Users can set the theme in {{Path|/etc/sddm.conf}}




Line 38: Line 38:
Many themes can be found on GitHub under the [https://github.com/topics/sddm-theme the sddm-theme topic].
Many themes can be found on GitHub under the [https://github.com/topics/sddm-theme the sddm-theme topic].


Copy a new theme folder to <code>/usr/share/sddm/themes/</code> and activate it by changing <code>Current=</code> to the name of the folder.
Copy a new theme folder to {{Path|/usr/share/sddm/themes/}} and activate it by changing <code>Current=</code> to the name of the folder.


==== Example ====
==== Example ====
Line 52: Line 52:
{{Cmd|# cp -r my-new-theme/ /usr/share/sddm/themes/}}
{{Cmd|# cp -r my-new-theme/ /usr/share/sddm/themes/}}


Edit the configuration file in <code>/etc</code>:
Edit the configuration file in {{Path|/etc}}:




Line 65: Line 65:
The default (fallback) theme, as well as other themes, can show an avatar on the login screen.
The default (fallback) theme, as well as other themes, can show an avatar on the login screen.


This avatar can be set by renaming the desired image to <code>~/.face.icon</code>
This avatar can be set by renaming the desired image to {{Path|~/.face.icon}}


== See also ==
== See also ==
Line 71: Line 71:
* [https://github.com/sddm/sddm/wiki SDDM Wiki]
* [https://github.com/sddm/sddm/wiki SDDM Wiki]
* [https://github.com/sddm/sddm/blob/develop/data/man/sddm.conf.rst.in sddm.conf options]
* [https://github.com/sddm/sddm/blob/develop/data/man/sddm.conf.rst.in sddm.conf options]
* [https://wiki.archlinux.org/title/SDDM SDDM - Archwiki]


[[Category:Desktop]]
[[Category:Desktop]]
[[Category:Display Managers]]
[[Category:Display Managers]]
[[Category:Wayland]]

Latest revision as of 23:24, 6 November 2023

SDDM, or Simple Desktop Display Manager, is a display manager for X11 and Wayland aiming to be fast, simple and beautiful. It is the recommended display manager for the KDE Plasma and LXQt desktop environments.

This page outlines the basic installation of SDDM, as well as some configuration options.

Installation

Begin by installing the sddm package:

# apk add sddm xorg-server-xephyr

Test the service to see if it launches and works, then enable the service to launch at boot:

# rc-service sddm start

(if it works)

# rc-update add sddm

Configuration

Under KDE, the appearance configuration tool can take care of some settings.

Manual configuration is possible too.

Themes

Themes for SDDM are located in /usr/share/sddm/themes/.

Users can set the theme in /etc/sddm.conf


Contents of /etc/sddm.conf

... [Theme] Current=''current_theme'' ...

Many themes can be found on GitHub under the the sddm-theme topic.

Copy a new theme folder to /usr/share/sddm/themes/ and activate it by changing Current= to the name of the folder.

Example

Given a folder containing a theme, my-new-theme.

Test your theme:

$ sddm-greeter --test-mode --theme my-new-theme/

If it looks as desire, copy it to the system themes folder:

# cp -r my-new-theme/ /usr/share/sddm/themes/

Edit the configuration file in /etc:


Contents of /etc/sddm.conf

... [Theme] Current=my-new-theme ...

Face icon / Avatar

The default (fallback) theme, as well as other themes, can show an avatar on the login screen.

This avatar can be set by renaming the desired image to ~/.face.icon

See also