https://github.com/qwreey/quick-settings-tweaks

Let's tweak gnome Quick Settings! You can add Media Controls, Notifications, Volume Mixer on quick settings and remove useless buttons!
https://github.com/qwreey/quick-settings-tweaks

Last synced: about 1 year ago
JSON representation

Let's tweak gnome Quick Settings! You can add Media Controls, Notifications, Volume Mixer on quick settings and remove useless buttons!

• Host: GitHub
• URL: https://github.com/qwreey/quick-settings-tweaks
• Owner: qwreey
• License: gpl-3.0
• Created: 2022-10-23T12:42:09.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2025-03-17T02:06:54.000Z (over 1 year ago)
• Last Synced: 2025-04-11T23:16:02.391Z (about 1 year ago)
• Language: TypeScript
• Homepage: https://extensions.gnome.org/extension/5446/quick-settings-tweaker/
• Size: 5.26 MB
• Stars: 419
• Watchers: 4
• Forks: 27
• Open Issues: 61
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Quick Settings Tweaks [](https://extensions.gnome.org/extension/5446/quick-settings-tweaker/)



### Let's tweak Gnome Quick Settings!

[](https://extensions.gnome.org/extension/5446/quick-settings-tweaker/)













Quick Settings Tweaker is a Gnome 46+ extension which allows you to customize the new Quick Settings Panel to your liking!









## Features

| 
With this extension, you can...
 | How it will appear |

|:-------------------------------|:--------------------:|

| 
**Add the Media Controls Widget**
Control your music and videos directly from the Quick Settings, instead of the Date Menu.

For a cooler look, you can also get colors from the cover image and create a gradient.
 |  |

| 
**Add the Volume Mixer Widget**
Adjust application volumes, without opening extra application.

Place the menu button next to the output slider for a compact and natural layout.
 |  |

| 
**Add the Notifications Widget**
You can check what has been sent to your mailbox or messenger, without missing!
 |  |

| 
**Layout customize**
Hide, re-order, re-color your panel and Quick Settings layout

Make it simple and keep organized!
 |  |

| 
**Overlay menu layout**
Your Quick Settings panel is too big?

Try overlay layout! you can customize background and animation style too.
 |  |


## Sponsor

You can promote and support development by [github sponsor!](https://github.com/sponsors/qwreey) You can help keep this project maintained

Here is my sponsors, thank for your support!

[![sponsors](https://readme-contribs.as93.net/sponsors/qwreey?shape=square&margin=16&perRow=15&title=Qwreey's%20Sponsors&textColor=f5acff&backgroundColor=0e001a&fontFamily=cursive&fontSize=14&limit=90&footerText=none&outerBorderRadius=24)](https://github.com/sponsors/qwreey)

## Development

### Translations



You can help translate this extension by open a pull request, or using [weblate](http://weblate.paring.moe/engage/gs-quick-settings-tweaks/)

### Building

> Prerequirements: You need to install nodejs, bash, and gnome-shell for compiling extension from source

You can create development build by executing `TARGET=dev ./install.sh create-release`. make sure run `npm i` first to ensure all build dependencies installed

Or, you can get nightly preview build from [github releases tab](https://github.com/qwreey/quick-settings-tweaks/releases). Build extension from `dev` branch is not encouraged, because the `dev` branch has unchecked bleeding-edge features not guaranteed to work. github-preview build is tested by developer and much stable than building `dev` branch.

### Contribution and Issues

Keep in mind that there may be one or a few developers, but there may be many issues and users. I think you know how to behave with manners without even having to say it.

Please check github [project board page](https://github.com/users/qwreey/projects/2) for issue priority and progress.

#### Raise an issue

If you want to raise an issue, First, **you must search your issue first.** duplicated issue will be closed, and disturb developer's time.

Second, **you must attach a related log files, gnome version and extension version informations.** if you don't provide information much about your issue, it is hard to solve your issue. and to be clear, Please use `[migration]`, `[feature]`, `[bug]` prefix for issue title, It is very useful for searching and organizing issues

And last, **you must use well-formed english** You can use a translator or AI to write it, so avoid wasting time by having the developer translate and take notes. This takes up a surprising amount of the developer's time, making analysis very difficult, especially if the logs are mixed in English and other languages.

#### PR and code contribution

If you want to contribute, **you must pull `dev` branch, Not master branch.** master branch is release branch, because AUR and some user distributions use master branch as build source. **If you create pull-request to master branch, it will be closed.** you should re-open PR to dev branch.

### Testing

![gnome-docker devlopment screenshot](.github/images/dev-preview.png)

You can test extension with command `./install.sh dev`. You will need tigervnc client and docker in host. Tested in arch linux but it should working on any systemd based platform

You can re-build extension by log out and close vnc window or send SIGINT to exit dev docker.