1XDG-SETTINGS(1)               xdg-settings Manual              XDG-SETTINGS(1)
2
3
4

NAME

6       xdg-settings - get various settings from the desktop environment
7

SYNOPSIS

9       xdg-settings {get | check | set} {property} [subproperty] [value]
10
11       xdg-settings {--help | --list | --manual | --version}
12

DESCRIPTION

14       xdg-settings gets various settings from the desktop environment. For
15       instance, desktop environments often provide proxy configuration and
16       default web browser settings. Using xdg-settings these parameters can
17       be extracted for use by applications that do not use the desktop
18       environment's libraries (which would use the settings natively).
19
20       xdg-settings is for use inside a desktop session only. It is not
21       recommended to use xdg-settings as root.
22

OPTIONS

24       --help
25           Show command synopsis.
26
27       --list
28           List all properties xdg-settings knows about.
29
30       --manual
31           Show this manual page.
32
33       --version
34           Show the xdg-utils version information.
35

PROPERTIES

37       When using xdg-settings to get, check or set a destkop setting,
38       properties and possibly sub-properties are used to specify the setting
39       to be changed.
40
41       Some properties (such as default-web-browser) fully describe the
42       setting to be changed. Other properties (such as
43       default-url-scheme-handler) require more information (in this case the
44       actual scheme to set the default handler for) which must be provided in
45       a sub-property.
46

EXIT CODES

48       An exit code of 0 indicates success while a non-zero exit code
49       indicates failure. The following failure codes can be returned:
50
51       1
52           Error in command line syntax.
53
54       2
55           One of the files passed on the command line did not exist.
56
57       3
58           A required tool could not be found.
59
60       4
61           The action failed.
62

EXAMPLES

64       Get the desktop file name of the current default web browser
65
66                   xdg-settings get default-web-browser
67
68
69       Check whether the default web browser is firefox.desktop, which can be
70       false even if "get default-web-browser" says that is the current value
71       (if only some of the underlying settings actually reflect that value)
72
73                   xdg-settings check default-web-browser firefox.desktop
74
75
76       Set the default web browser to google-chrome.desktop
77
78                   xdg-settings set default-web-browser google-chrome.desktop
79
80
81       Set the default mailto URL scheme handler to be evolution.desktop
82
83                   xdg-settings set default-url-scheme-handler mailto evolution.desktop
84
85
86

AUTHOR

88       Mike Mammarella
89           Author.
90

92       Copyright © 2009-2011
93
94
95
96[FIXME: source]                   11/05/2016                   XDG-SETTINGS(1)
Impressum