Xfce Wiki

Sub domains
 
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


Next revision
—xfce:xfconf:xfconf-query [2012/04/29 14:28] – created andrzejr
Line 1: Line 1:
 +====== Xfconf-query ======
 +
 +Xfconf-query is a Command Line Interface (CLI) tool for accessing configuration data stored in [[xfce:xfconf:|Xfconf]]. Settings can be displayed and changed in real time. In most cases, any modifications will immediately be propagated to respective applications. Similarly, xfconf-query can display most current configuration options set by the applications or monitor configuration channels for any changes.
 +
 +===== Usage =====
 +
 +  xfconf-query [OPTION...]
 +
 +==== Available options ====
 +
 +? -h, --help
 +! Show help options
 +? -V, --version
 +! Version information
 +? -c, --channel
 +! The channel to query/modify
 +? -p, --property
 +! The property to query/modify
 +? -s, --set
 +! The new value to set for the property
 +? -l, --list
 +! List properties (or channels if -c is not specified)
 +? -v, --verbose
 +! Verbose output
 +? -n, --create
 +! Create a new property if it does not already exist
 +? -t, --type
 +! Specify the property value type
 +? -r, --reset
 +! Reset property
 +? -R, --recursive
 +! Recursive (use with -r)
 +? -a, --force-array
 +! Force array even if only one element
 +? -T, --toggle
 +! Invert an existing boolean property
 +? -m, --monitor
 +! Monitor a channel for property changes
 +
 +===== Examples =====
 +
 +List all available configuration channels:
 +
 +  xfconf-query -l
 +
 +List all available properties in the channel ''xfce4-panel'':
 +
 +  xfconf-query -c xfce4-panel -l
 +
 +List all available properties and their values in the channel ''xfce4-panel'':
 +
 +  xfconf-query -c xfce4-panel -l -v
 +
 +List all properties and their values in the channel ''xfce4-panel'' below the property ''/panels'' (including it):
 +
 +  xfconf-query -c xfce4-panel -p /panels -l -v
 +
 +Create a new property ''/test1'' in the channel ''test'', holding an integer value ''1'':
 +
 +  xfconf-query -c test -p /test1 -n -t int -s 1
 +
 +Reset (and remove) property ''/test1'' in the channel ''test'' (this preserves any properties under ''/test1'', for example ''/test1/test''):
 +
 +  xfconf-query -c test -p /test1 -r
 +
 +Reset (and remove) property ''/test1'' in the channel ''test'' and all properties under it:
 +
 +  xfconf-query -c test -p /test1 -r -R
 +
 +
 +
 +Create a new property ''/test2'' in the channel ''test'', holding an array of two integers and two strings (''[int,int,string,string]''), and preset it with an array ''[4,5,"6","8"]'':
 +
 +  xfconf-query -c test -p /test2 -n -t int -t int -t string -t string -s 4 -s 5 -s 6 -s 8
 +
 +Create a new property ''/test3'' in the channel ''test'', holding an array of a single string value (''[string]''), and preset it with an array ''["123"]'' (note that without ''-a'' the property type would be ''string''):
 +
 +  xfconf-query -c test -p /test3 -n -t string -s 123 -a
 +
 +Monitor changes in the ''xfce4-panel'' channel:
 +
 +  xfconf-query -c xfce4-panel -m
 +
 +Monitor changes in the ''xfce4-panel'' channel while displaying values of properties being set:
 +
 +  xfconf-query -c xfce4-panel -m -v