gnome_desktop

This configuration helps set up the GNOME 3+ desktop environment.

Requirements

This setup does not install the GNOME desktop; it must already be installed. The tool dconf and other necessary items will be installed automatically.

Role Variables

Top bar settings

Variable	Default	Description
gnome_topbar_time_24h	true	Show time in 24-hour format
gnome_topbar_time_seconds	false	Show seconds in the top bar
gnome_topbar_show_weekday	true	Show the weekday in the top bar
gnome_battery_percentage	false	Show battery percentage

Shell settings

Variable	Default	Description
gnome_shell_animations	true	Enable animations in GNOME Shell
gnome_shell_hotcorners	true	Enable hot corners in GNOME Shell

Window manager settings

Variable	Default	Description
gnome_wm_buttons	"'appmenu:minimize,maximize,close'"	Custom button layout

Hardware settings

Variable	Default	Description
gnome_ambient_light	true	Enable ambient light sensor

Mouse/Keyboard settings

Variable	Default	Description
gnome_mouse_natural_scrolling	true	Enable natural scrolling
gnome_desktop_shortcut	true	Create/restore desktop shortcut (SUPER+D)

Other settings

Variable	Default	Description
gnome_additional_settings	true	Additional settings in a list

Installing extensions

To install extensions automatically, you need:

• The correct download link for your GNOME Shell version
• The extension UUID

You can find this info by visiting the GNOME extension catalog, selecting the version you need, and copying the download link. After downloading, extract the file and check the uuid value in metadata.json.

Here’s an example YAML code to install a Podman extension for GNOME 41:

gnome_extensions:
  - name: containers@royg
    url: https://extensions.gnome.org/extension-data/containersroyg.v19.shell-extension.zip

Dependencies

No dependencies.

Example Playbook

Here's an example of how to use this setup:

---
- hosts: servers
  roles:
    - stdevel.gnome_desktop

You can set variables as needed, for example:

---
- hosts: uyuni.giertz.loc
  roles:
    - role: stdevel.gnome_desktop
      gnome_additional_settings:
        - setting: "/org/gnome/desktop/privacy/report-technical-problems"
          value: "false"
        - setting: "/org/gnome/desktop/privacy/send-software-usage-stats"
          value: "false"
        - setting: "/org/gnome/desktop/wm/keybindings/minimize"
          value: ['']
        - setting: "/dummy/setting"
          state: absent
      gnome_extensions:
        - name: containers@royg
          url: https://extensions.gnome.org/extension-data/containersroyg.v19.shell-extension.zip

License

Apache 2.0

Author Information

Christian Stankowic (info@cstan.io)