community.general.xfconf module – Edit XFCE4 Configurations
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.xfconf
.
Synopsis
This module allows for the manipulation of Xfce 4 Configuration with the help of xfconf-query. Please see the xfconf-query(1) man page for more details.
Aliases: system.xfconf
Parameters
Parameter |
Comments |
---|---|
A Xfconf preference channel is a top-level tree key, inside of the Xfconf repository that corresponds to the location for which all application properties/keys are stored. See man xfconf-query(1). |
|
Force array even if only one element. Choices:
|
|
A Xfce preference key is an element in the Xfconf repository that corresponds to an application preference. See man xfconf-query(1). |
|
The action to take upon the property/value. The state Choices:
|
|
Preference properties typically have simple values such as strings, integers, or lists of strings and integers. See man xfconf-query(1). |
|
The type of value being set. When providing more than one If only one If the Support for Choices:
|
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in |
|
Support: full |
Will return details on what has changed (or possibly needs changing in |
See Also
See also
- xfconf-query(1) man page
Manual page of the
xfconf-query
tool at the XFCE documentation site.- xfconf - Configuration Storage System
XFCE documentation for the Xfconf configuration system.
Examples
- name: Change the DPI to "192"
xfconf:
channel: "xsettings"
property: "/Xft/DPI"
value_type: "int"
value: "192"
- name: Set workspace names (4)
xfconf:
channel: xfwm4
property: /general/workspace_names
value_type: string
value: ['Main', 'Work1', 'Work2', 'Tmp']
- name: Set workspace names (1)
xfconf:
channel: xfwm4
property: /general/workspace_names
value_type: string
value: ['Main']
force_array: true
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The channel specified in the module parameters Returned: success Sample: |
|
A list with the resulting Returned: success Sample: |
|
The value of the preference key before executing the module. Either a single string value or a list of strings for array types. This is a string or a list of strings. Returned: success Sample: |
|
The property specified in the module parameters Returned: success Sample: |
|
The value of the preference key after executing the module. Either a single string value or a list of strings for array types. This is a string or a list of strings. Returned: success Sample: |
|
The type of the value that was changed ( This is a string or a list of strings. Returned: success Sample: |