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 desktop 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

SEE ALSO

64       xdg-mime(1), xdg-open(1), MIME applications associations
65       specification[1]
66

EXAMPLES

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

AUTHOR

92       Mike Mammarella
93           Author.
94

96       Copyright © 2009-2011
97

NOTES

99        1. MIME applications associations specification
100           http://www.freedesktop.org/wiki/Specifications/mime-apps-spec/
101
102
103
104xdg-utils 1.1.0                   07/25/2023                   XDG-SETTINGS(1)
Impressum