{"id":50476,"date":"2026-01-25T11:50:52","date_gmt":"2026-01-25T11:50:52","guid":{"rendered":"https:\/\/ubuntuhandbook.org\/?p=50476"},"modified":"2026-01-25T11:50:52","modified_gmt":"2026-01-25T11:50:52","slug":"custom-toggle-buttons-quick-settings","status":"publish","type":"post","link":"https:\/\/ubuntuhandbook.org\/index.php\/2026\/01\/custom-toggle-buttons-quick-settings\/","title":{"rendered":"Add Custom Toggle Buttons to Top-right System Menu (Quick Settings)"},"content":{"rendered":"

\"\"<\/p>\n

Want to add custom ON\/OFF toggle buttons to the top-right system menu (aka Quick Settings) in Ubuntu, Fedora Workstation and other Linux with recent GNOME desktop? Here’s an extension can do the job!<\/p>\n

GNOME since 43 introduced a redesigned system status menu called Quick Settings, allowing to quickly change commonly used settings via ON\/OFF toggle buttons.<\/p>\n

<\/p>\n

\"\"<\/p>\n

The menu by default includes the toggle buttons to change the network, bluetooth, night light, keyboard back-light, Light\/Dark status, as well as CPU power mode.<\/p>\n

If that’s not enough, then you can add more buttons for custom actions, such as automatic suspend and\/or webcam toggles. And, here’s how to do the job step by step.<\/p>\n

Step 1: Install the Custom Command Toggle extension<\/h3>\n

The extension so far supports GNOME from version 45 to 49<\/b>, meaning for Ubuntu 24.04 ~ 25.10, all current supported Fedora Workstation, Debian 13, and Arch etc Linux distributions with GNOME.<\/p>\n

First, search and install “Extension Manager” app from your system software app, such as App Center or GNOME Software.<\/p>\n

\"\"<\/p>\n

Then, launch Extension Manager and use it to search and install “Custom Command Toggle” extension under Browse<\/i> tab.<\/p>\n

\"\"<\/p>\n

If your Linux Distribution does not have “Extension Manager” app in system repository, then visit the link below in web browser, and use the ON\/OFF toggle to install it:<\/p>\n

\n
Custom Command Toggle<\/a><\/div>\n<\/div>\n

Though, you need to install the browser extension first and refresh to see the toggle. And, Debian\/Ubuntu need to install agent package first by running the command below in temrinal:<\/p>\n

sudo apt install chrome-gnome-shell<\/pre>\n
\"\"<\/p>\n
Step 2: Add\/Configure Toggle Buttons to Quick Settings<\/h3>\n
After installed the extension, either go to Installed<\/i> tab in Extension Manager then click the gear icon to open preferences.<\/p>\n
\"\"<\/p>\n
Or, run the command below to launch the preferences from terminal:<\/p>\n
gnome-extensions prefs custom-command-toggle@storageb.github.com<\/pre>\n
When the preferences dialog opens, you may switch to “Configuration” tab to increase the number of custom toggle buttons (up to 6). And, each button will has its own tab in the dialog.<\/p>\n
\"\"<\/p>\n
Next, input the text and icon to be displayed on that button. For Ubuntu with default Yaru theme, see this page<\/a> for all the available symbolic icon names. And, go to this page<\/a> for Gnome default Adwaita icons.<\/p>\n
And, type the commands for toggle ON\/OFF actions. For example, use the command below to enable automatic suspend for both battery and AC mode, for button ON.<\/p>\n
gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-type suspend && gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-type suspend<\/pre>\n
And, use the command below to disable automatic suspend for button OFF state.<\/p>\n
gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-type nothing && gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-type nothing<\/pre>\n
\"\"<\/p>\n
As you see, you may use &&<\/code> to connect multiple commands into one. And, use pkexec<\/code> for command that need root permission.<\/p>\n
For example, use the command below to disable webcam\/camera for button OFF:<\/p>\n
pkexec modprobe --remove uvcvideo<\/pre>\n
And use the command below instead to re-enable for button ON:<\/p>\n
pkexec modprobe uvcvideo<\/pre>\n
NOTE: the modprobe<\/code> kernel module load\/remove commands only work when the module is not in use. If your webcam\/camera is being opened by an application, then the commands won’t work.<\/p>\n
The initial button state at start up (after login) is by default set to previous state. Advanced users may set it to “Command output”, so it will run the “Check Status Command” automatically at login, and set button state automatically according if that command output matches the “Check Status Search Term”. <\/p>\n
For more about the extension, see the official wiki<\/a>.<\/p>","protected":false},"excerpt":{"rendered":"
Want to add custom ON\/OFF toggle buttons to the top-right system menu (aka Quick Settings) in Ubuntu, Fedora Workstation and other Linux with recent GNOME desktop? Here’s an extension can do the job! GNOME since 43 introduced a redesigned system status menu called Quick Settings, allowing to quickly change commonly used settings via ON\/OFF toggle […]<\/p>\n","protected":false},"author":1,"featured_media":44710,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[689],"class_list":["post-50476","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howtos","tag-gnome"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts\/50476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/comments?post=50476"}],"version-history":[{"count":0,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts\/50476\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/media\/44710"}],"wp:attachment":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/media?parent=50476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/categories?post=50476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/tags?post=50476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}