{
    "content": [
        {
            "type": "text",
            "text": "# xdg-settings(1) (man)\n\n**Summary:** xdg-settings - get various settings from the desktop environment\n\n**Synopsis:** xdg-settings {get | check | set} {property} [subproperty] [value]\nxdg-settings {--help | --list | --manual | --version}\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| — | --help | — | Show command synopsis. |\n| — | --list | — | List all properties xdg-settings knows about. |\n| — | --manual | — | Show this manual page. |\n| — | --version | — | Show the xdg-utils version information. |\n\n## Examples\n\n- `Get the desktop file name of the current default web browser`\n- `xdg-settings get default-web-browser`\n- `Check whether the default web browser is firefox.desktop, which can be false even if \"get`\n- `default-web-browser\" says that is the current value (if only some of the underlying settings`\n- `actually reflect that value)`\n- `xdg-settings check default-web-browser firefox.desktop`\n- `Set the default web browser to google-chrome.desktop`\n- `xdg-settings set default-web-browser google-chrome.desktop`\n- `Set the default mailto URL scheme handler to be evolution.desktop`\n- `xdg-settings set default-url-scheme-handler mailto evolution.desktop`\n\n## See Also\n\n- xdg-mime(1)\n- xdg-open(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (8 lines)\n- **OPTIONS** (1 lines) — 4 subsections\n  - --help (2 lines)\n  - --list (2 lines)\n  - --manual (2 lines)\n  - --version (2 lines)\n- **PROPERTIES** (7 lines)\n- **EXIT CODES** (15 lines)\n- **SEE ALSO** (2 lines)\n- **EXAMPLES** (23 lines)\n- **AUTHOR** (1 lines) — 1 subsections\n  - Mike Mammarella (2 lines)\n- **COPYRIGHT** (2 lines)\n- **NOTES** (6 lines)\n\n## Full Content\n\n### NAME\n\nxdg-settings - get various settings from the desktop environment\n\n### SYNOPSIS\n\nxdg-settings {get | check | set} {property} [subproperty] [value]\n\nxdg-settings {--help | --list | --manual | --version}\n\n### DESCRIPTION\n\nxdg-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\n### OPTIONS\n\n#### --help\n\nShow command synopsis.\n\n#### --list\n\nList all properties xdg-settings knows about.\n\n#### --manual\n\nShow this manual page.\n\n#### --version\n\nShow the xdg-utils version information.\n\n### PROPERTIES\n\nWhen 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\n### EXIT CODES\n\nAn 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\n### SEE ALSO\n\nxdg-mime(1), xdg-open(1), MIME applications associations specification[1]\n\n### EXAMPLES\n\nGet 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### AUTHOR\n\n#### Mike Mammarella\n\nAuthor.\n\n### COPYRIGHT\n\nCopyright © 2009-2011\n\n### NOTES\n\n1. 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)\n\n"
        }
    ],
    "structuredContent": {
        "command": "xdg-settings",
        "section": "1",
        "mode": "man",
        "summary": "xdg-settings - get various settings from the desktop environment",
        "synopsis": "xdg-settings {get | check | set} {property} [subproperty] [value]\nxdg-settings {--help | --list | --manual | --version}",
        "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"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 8,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "--help",
                        "lines": 2,
                        "long": "--help"
                    },
                    {
                        "name": "--list",
                        "lines": 2,
                        "long": "--list"
                    },
                    {
                        "name": "--manual",
                        "lines": 2,
                        "long": "--manual"
                    },
                    {
                        "name": "--version",
                        "lines": 2,
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "PROPERTIES",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "EXIT CODES",
                "lines": 15,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "EXAMPLES",
                "lines": 23,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 1,
                "subsections": [
                    {
                        "name": "Mike Mammarella",
                        "lines": 2
                    }
                ]
            },
            {
                "name": "COPYRIGHT",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "NOTES",
                "lines": 6,
                "subsections": []
            }
        ]
    }
}