|
2 | 2 |
|
3 | 3 | #### A GNOME extension to create custom quick toggle buttons.
|
4 | 4 |
|
5 |
| -Custom Command Toggle is an extension for GNOME 45/46/47/48 to create custom fully customizable quick toggle buttons. |
| 5 | +Custom Command Toggle is an extension for GNOME 45/46/47/48 to create fully customizable quick toggle buttons. |
6 | 6 |
|
7 | 7 | <br>
|
8 | 8 |
|
9 |
| - |
| 9 | + |
10 | 10 |
|
11 | 11 | <br>
|
12 | 12 |
|
13 | 13 | ## Features:
|
14 | 14 |
|
15 |
| -- Assign custom button names and icons in the extension preferences. |
16 | 15 | - Run terminal commands and launch custom scripts using quick toggle buttons.
|
| 16 | +- Assign custom button names and icons. |
17 | 17 | - Enter separate commands to run when the button is switched on and when it is switched off.
|
18 | 18 | - Run a command at startup to determine the button's initial state based on the command output, or manually specify whether the button starts as on, off, or in its last known state.
|
19 |
| -- Run associated command at startup to sync button state if required. |
| 19 | +- Run associated on or off command at startup to sync button state if required. |
20 | 20 | - Option to toggle the button only if the command executes successfully and returns exit code 0 (for use with sudo commands using `pkexec sudo` where the command could be canceled or incorrect password entered).
|
21 | 21 | - Customize toggle button behavior to toggle or be in an always on or off state.
|
22 | 22 | - Assign keyboard shortcuts to quick toggle buttons.
|
@@ -48,15 +48,15 @@ Browse for and install this extension through the GNOME Extension Manager, or in
|
48 | 48 |
|
49 | 49 | In the Configuration tab under Settings, select the number of toggle buttons to create (maximum of 6). Note that this requires logging off/on or rebooting for changes to take effect.
|
50 | 50 |
|
51 |
| -There is also an option to export the current configuration for all of the toggle buttons to a file for backup purposes. |
| 51 | +There is also an option to export the current configuration for all the toggle buttons to a file for backup purposes. |
52 | 52 |
|
53 | 53 | 
|
54 | 54 |
|
55 | 55 | <br>
|
56 | 56 |
|
57 | 57 | ### Appearance
|
58 | 58 |
|
59 |
| -Enter the text and icon information to use for the quick toggle button. |
| 59 | +Enter the name and icon information to use for the quick toggle button. |
60 | 60 |
|
61 | 61 | 
|
62 | 62 |
|
|
81 | 81 | - Chain multiple commands together to run one at a time using `&&` between commands.
|
82 | 82 | - By default, commands do not run in a terminal window and will not show any output or error messages. Test the full command first by running it in the terminal before adding it to the extension to verify it is correct.
|
83 | 83 | - To run a command in a terminal window, use `gnome-terminal -- command`. Note that by default the GNOME terminal will close after the command is complete, but that can be changed in the terminal preferences if needed.
|
84 |
| -- For sudo commands that require a password, use `pkexec` before the command to get a password prompt. For example, p`kexec sudo command` will prompt for your password and then run the command. Alternatively, you can use `gnome-terminal -- sudo command` to open a terminal where you can enter your password. |
| 84 | +- For sudo commands that require a password, use `pkexec` before the command to get a password prompt. For example, `pkexec sudo command` will prompt for your password and then run the command. Alternatively, you can use `gnome-terminal -- sudo command` to open a terminal where you can enter your password. |
85 | 85 |
|
86 | 86 | <br>
|
87 | 87 |
|
|
0 commit comments