m-wynn / sddm_wynn-theme

Material Design sddm theme
Creative Commons Attribution Share Alike 4.0 International
24 stars 5 forks source link
greeter login material sddm sddm-theme theme

sddm_wynn theme

A flexible, configurable, material SDDM theme. Most values are configurable via the theme.conf file.

Screenshots (some functionality not shown)

Screenshot

Features

Installation

  1. Install sddm
  2. git clone https://github.com/m-wynn/sddm_wynn-theme.git /usr/share/sddm/themes/sddm_wynn-theme
  3. chmod -R 755 /usr/share/sddm/themes/sddm_wynn-theme
  4. Install qml dependencies (qt5-graphicaleffects and qt5-quickcontrols2)
  5. Put "Current=sddm_wynn-theme" in the [Theme] section of /etc/sddm.conf

Configuration file values

You can create a theme.conf.user file in the theme folder, which will override the defaults.

Session API

The session API value is useful if, for example, you are running a linux lab of many users, and users can choose a desktop environment to be associated with their account. As an example, this could be done via LDAP and an small web API.

The greeter theme will read your session_api value from the configuration file, replace %s with the username, perform an HTTP GET request, and use the body of the result as the session name. Again, the session name should be the sessionname in /usr/share/xsessions/sessionname.desktop (i.e. cinnamon or cinnamon2d, NOT Cinnamon (Software Rendering)). If the API returns N, then it will reset to the default_session configuration value.

For example, if your session_api is http://ldap-api.mylab.com/%s/session/0 and a user types in their name m_wynn into the username box, as soon as they focus away from the username box, the theme will GET http://ldap-api.mylab.com/m_wynn/session/0. If the result is N, the default_session will be used. Otherwise, the body of the response (i.e. "cinnamon") is used as the session name.