{
    "mode": "man",
    "parameter": "xdg-settings",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/xdg-settings/1/json",
    "generated": "2026-05-30T05:15:25Z",
    "synopsis": "xdg-settings {get | check | set} {property} [subproperty] [value]\nxdg-settings {--help | --list | --manual | --version}",
    "sections": {
        "NAME": {
            "content": "xdg-settings - get various settings from the desktop environment\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "xdg-settings {get | check | set} {property} [subproperty] [value]\n\nxdg-settings {--help | --list | --manual | --version}\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "xdg-settings gets various settings from the desktop environment. For instance, desktop\nenvironments often provide proxy configuration and default web browser settings. Using\nxdg-settings these parameters can be extracted for use by applications that do not use the\ndesktop environment's libraries (which would use the settings natively).\n\nxdg-settings is for use inside a desktop session only. It is not recommended to use\nxdg-settings as root.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "--help",
                    "content": "Show command synopsis.\n",
                    "long": "--help"
                },
                {
                    "name": "--list",
                    "content": "List all properties xdg-settings knows about.\n",
                    "long": "--list"
                },
                {
                    "name": "--manual",
                    "content": "Show this manual page.\n",
                    "long": "--manual"
                },
                {
                    "name": "--version",
                    "content": "Show the xdg-utils version information.\n",
                    "long": "--version"
                }
            ]
        },
        "PROPERTIES": {
            "content": "When using xdg-settings to get, check or set a desktop setting, properties and possibly\nsub-properties are used to specify the setting to be changed.\n\nSome properties (such as default-web-browser) fully describe the setting to be changed. Other\nproperties (such as default-url-scheme-handler) require more information (in this case the\nactual scheme to set the default handler for) which must be provided in a sub-property.\n",
            "subsections": []
        },
        "EXIT CODES": {
            "content": "An exit code of 0 indicates success while a non-zero exit code indicates failure. The\nfollowing failure codes can be returned:\n\n1\nError in command line syntax.\n\n2\nOne of the files passed on the command line did not exist.\n\n3\nA required tool could not be found.\n\n4\nThe action failed.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "xdg-mime(1), xdg-open(1), MIME applications associations specification[1]\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "Get the desktop file name of the current default web browser\n\nxdg-settings get default-web-browser\n\n\nCheck whether the default web browser is firefox.desktop, which can be false even if \"get\ndefault-web-browser\" says that is the current value (if only some of the underlying settings\nactually reflect that value)\n\nxdg-settings check default-web-browser firefox.desktop\n\n\nSet the default web browser to google-chrome.desktop\n\nxdg-settings set default-web-browser google-chrome.desktop\n\n\nSet the default mailto URL scheme handler to be evolution.desktop\n\nxdg-settings set default-url-scheme-handler mailto evolution.desktop\n\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "",
            "subsections": [
                {
                    "name": "Mike Mammarella",
                    "content": "Author.\n"
                }
            ]
        },
        "COPYRIGHT": {
            "content": "Copyright © 2009-2011\n",
            "subsections": []
        },
        "NOTES": {
            "content": "1. MIME applications associations specification\nhttp://www.freedesktop.org/wiki/Specifications/mime-apps-spec/\n\n\n\nxdg-utils 1.1.0                              08/22/2022                              XDG-SETTINGS(1)",
            "subsections": []
        }
    },
    "summary": "xdg-settings - get various settings from the desktop environment",
    "flags": [
        {
            "flag": "",
            "long": "--help",
            "arg": null,
            "description": "Show command synopsis."
        },
        {
            "flag": "",
            "long": "--list",
            "arg": null,
            "description": "List all properties xdg-settings knows about."
        },
        {
            "flag": "",
            "long": "--manual",
            "arg": null,
            "description": "Show this manual page."
        },
        {
            "flag": "",
            "long": "--version",
            "arg": null,
            "description": "Show the xdg-utils version information."
        }
    ],
    "examples": [
        "Get the desktop file name of the current default web browser",
        "xdg-settings get default-web-browser",
        "Check whether the default web browser is firefox.desktop, which can be false even if \"get",
        "default-web-browser\" says that is the current value (if only some of the underlying settings",
        "actually reflect that value)",
        "xdg-settings check default-web-browser firefox.desktop",
        "Set the default web browser to google-chrome.desktop",
        "xdg-settings set default-web-browser google-chrome.desktop",
        "Set the default mailto URL scheme handler to be evolution.desktop",
        "xdg-settings set default-url-scheme-handler mailto evolution.desktop"
    ],
    "see_also": [
        {
            "name": "xdg-mime",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/xdg-mime/1/json"
        },
        {
            "name": "xdg-open",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/xdg-open/1/json"
        }
    ]
}