# watch-xfce-xfconf - Automate XFCE Configuration!
## Introduction
The command-line tool `watch-xfce-xfconf`, written by
[James Cherti](https://www.jamescherti.com/), allows displaying and watching the
xfconf-query commands of all the XFCE 4 Xfconf settings that are being changed by XFCE
programs like xfce4-settings-manager, thunar, catfish, ristretto, among others.
The `watch-xfce-xfconf` command-line tool is especially useful for users who want to
replicate XFCE 4 settings on several computers.
### What is xfconf-query?
The xfconf-query command-line tool allows retrieving, modifying, and creating XFCE 4
Xfconf settings, such as the desktop background, panel preferences, window decorations,
window manager settings, and more.
### How can xfconf-query commands help automate the configuration of XFCE 4?
By displaying the xfconf-query commands, `watch-xfce-xfconf` allows to easily create a
Shell script that can be used to automate the configuration of XFCE 4, which provides
several benefits:
- It saves time and effort by eliminating the need to manually adjust settings on each
individual machine,
- It reduces the risk of errors and inconsistencies that may arise from manually
configuring settings on different machines,
- Finally, it allows focusing on other important tasks rather than spending time
configuring XFCE 4 manually.
## Installation
The watch-xfce-xfconf command-line tool can be installed locally,
in `~/.local/bin/watch-xfce-xfconf`, using pip:
```console
pip install --user watch-xfce-xfconf
```
## Usage
Run xfce4-settings-manager in the background:
```console
xfce4-settings-manager &
```
After that, execute watch-xfce-xfconf:
```console
~/.local/bin/watch-xfce-xfconf
```
Once you begin modifying XFCE 4 settings using xfce4-settings-manager, `watch-xfce-xfconf`
will automatically display the corresponding xfconf-query commands in the terminal. These
xfconf-query commands can be easily copied and pasted into a Shell script, allowing for
quick and efficient automation of XFCE 4 configuration across multiple machines.
## Features
- Parses XML files that are located in the directory:
`~/.config/xfce4/xfconf/xfce-perchannel-xml/`,
- Monitors changes in XFCE 4 settings / Xfconf,
- Displays xfconf-query commands,
- Supports the following Xfconf types: uint, int, string, bool, array, double.
## Links
- [watch-xfce-xfconf @PyPI](https://pypi.org/project/watch-xfce-xfconf/)
- [watch-xfce-xfconf @GitHub](https://github.com/jamescherti/watch-xfce-xfconf/)
- [General information about Xfconf](https://docs.xfce.org/xfce/xfconf/start)
Raw data
{
"_id": null,
"home_page": "https://github.com/jamescherti/watch-xfce-xfconf",
"name": "watch-xfce-xfconf",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6, <4",
"maintainer_email": "",
"keywords": "",
"author": "James Cherti",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/a8/2f/0619c67a6fcde500681dc818910abea5ce931c4d667b444d0cbc1171c064/watch-xfce-xfconf-1.0.5.tar.gz",
"platform": null,
"description": "# watch-xfce-xfconf - Automate XFCE Configuration!\n\n## Introduction\n\nThe command-line tool `watch-xfce-xfconf`, written by\n[James Cherti](https://www.jamescherti.com/), allows displaying and watching the\nxfconf-query commands of all the XFCE 4 Xfconf settings that are being changed by XFCE\nprograms like xfce4-settings-manager, thunar, catfish, ristretto, among others.\n\nThe `watch-xfce-xfconf` command-line tool is especially useful for users who want to\nreplicate XFCE 4 settings on several computers.\n\n### What is xfconf-query?\n\nThe xfconf-query command-line tool allows retrieving, modifying, and creating XFCE 4\nXfconf settings, such as the desktop background, panel preferences, window decorations,\nwindow manager settings, and more.\n\n### How can xfconf-query commands help automate the configuration of XFCE 4?\n\nBy displaying the xfconf-query commands, `watch-xfce-xfconf` allows to easily create a\nShell script that can be used to automate the configuration of XFCE 4, which provides\nseveral benefits:\n- It saves time and effort by eliminating the need to manually adjust settings on each\n individual machine,\n- It reduces the risk of errors and inconsistencies that may arise from manually\n configuring settings on different machines,\n- Finally, it allows focusing on other important tasks rather than spending time\n configuring XFCE 4 manually.\n\n## Installation\n\nThe watch-xfce-xfconf command-line tool can be installed locally,\nin `~/.local/bin/watch-xfce-xfconf`, using pip:\n```console\npip install --user watch-xfce-xfconf\n```\n\n## Usage\n\nRun xfce4-settings-manager in the background:\n```console\nxfce4-settings-manager &\n```\n\nAfter that, execute watch-xfce-xfconf:\n```console\n~/.local/bin/watch-xfce-xfconf\n```\n\nOnce you begin modifying XFCE 4 settings using xfce4-settings-manager, `watch-xfce-xfconf`\nwill automatically display the corresponding xfconf-query commands in the terminal. These\nxfconf-query commands can be easily copied and pasted into a Shell script, allowing for\nquick and efficient automation of XFCE 4 configuration across multiple machines.\n\n## Features\n- Parses XML files that are located in the directory:\n `~/.config/xfce4/xfconf/xfce-perchannel-xml/`,\n- Monitors changes in XFCE 4 settings / Xfconf,\n- Displays xfconf-query commands,\n- Supports the following Xfconf types: uint, int, string, bool, array, double.\n\n## Links\n- [watch-xfce-xfconf @PyPI](https://pypi.org/project/watch-xfce-xfconf/)\n- [watch-xfce-xfconf @GitHub](https://github.com/jamescherti/watch-xfce-xfconf/)\n- [General information about Xfconf](https://docs.xfce.org/xfce/xfconf/start)\n",
"bugtrack_url": null,
"license": "",
"summary": "A command-line tool that can help you to configure XFCE 4 programmatically",
"version": "1.0.5",
"project_urls": {
"Homepage": "https://github.com/jamescherti/watch-xfce-xfconf"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5eed4d8c87e8559b4e6cce82b4646ae505947255ed30f04d687acbce1ef982dc",
"md5": "b1258db732144eab4011e7a45b49df41",
"sha256": "220c9c5c9bb94307831e8dbfa2af50afebdd9d1f97b3af30c2699b043f3aae27"
},
"downloads": -1,
"filename": "watch_xfce_xfconf-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b1258db732144eab4011e7a45b49df41",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6, <4",
"size": 9578,
"upload_time": "2023-11-12T00:56:47",
"upload_time_iso_8601": "2023-11-12T00:56:47.465135Z",
"url": "https://files.pythonhosted.org/packages/5e/ed/4d8c87e8559b4e6cce82b4646ae505947255ed30f04d687acbce1ef982dc/watch_xfce_xfconf-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a82f0619c67a6fcde500681dc818910abea5ce931c4d667b444d0cbc1171c064",
"md5": "5aa01fb8c9d4eed322e62c0a087f83ca",
"sha256": "4b7404bc8e490362296a1ed1dc2f4347adf4d634b292b3b2035bd44080a6ad6c"
},
"downloads": -1,
"filename": "watch-xfce-xfconf-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "5aa01fb8c9d4eed322e62c0a087f83ca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6, <4",
"size": 8041,
"upload_time": "2023-11-12T00:56:49",
"upload_time_iso_8601": "2023-11-12T00:56:49.178370Z",
"url": "https://files.pythonhosted.org/packages/a8/2f/0619c67a6fcde500681dc818910abea5ce931c4d667b444d0cbc1171c064/watch-xfce-xfconf-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-12 00:56:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jamescherti",
"github_project": "watch-xfce-xfconf",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "watch-xfce-xfconf"
}
JSON
