https://github.com/quantumvoid0/better-control
A simple control panel for linux , based on the GTK framework
https://github.com/quantumvoid0/better-control
control gtk linux python settings
Last synced: 27 days ago
JSON representation
A simple control panel for linux , based on the GTK framework
- Host: GitHub
- URL: https://github.com/quantumvoid0/better-control
- Owner: quantumvoid0
- License: other
- Created: 2025-03-11T08:21:38.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-03T13:04:44.000Z (28 days ago)
- Last Synced: 2025-04-03T13:34:47.097Z (28 days ago)
- Topics: control, gtk, linux, python, settings
- Language: Python
- Homepage:
- Size: 7.59 MB
- Stars: 150
- Watchers: 4
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚙️ Better Control ⚙️
### *A sleek GTK-themed control panel for Linux* 🐧
[](https://aur.archlinux.org/packages/better-control-git)
[](LICENSE)
[](https://github.com/quantumvoid0/better-control/stargazers)
> [!NOTE]
> 🎨 The application follows your system GTK theme for a native and integrated look.
> [!IMPORTANT]
> 🚧 This project is under active development. Contributions, feature requests, ideas, and testers are welcome!
## ✨ Features
- 🔄 Seamless integration with your desktop environment
- 📱 Modern, clean interface for system controls
- 🎚️ Quick access to common system settings
- 🌙 Respects your system's light/dark theme settings
- 🧩 Modular design - use only what you need
## 📋 Requirements
Before installing, ensure you have `git` and `base-devel` installed.
### Core Dependencies
| Dependency | Purpose |
|------------|---------|
| **GTK 3** | UI framework |
| **Python Libraries** | python-gobject, python-dbus, python-psutil |
### Feature-Specific Dependencies
| Feature | Required Packages |
|---------|------------------|
| **Wi-Fi Management** | NetworkManager, python-qrcode |
| **Bluetooth** | BlueZ & BlueZ Utils |
| **Audio Control** | PipeWire or PulseAudio |
| **Brightness** | brightnessctl |
| **Power Management** | power-profiles-daemon, upower |
| **Blue Light Filter** | gammastep |
> [!TIP]
> If you don't need a specific feature, you can safely omit its corresponding dependency and hide its tab in the settings.
### Usage
`control` or `better-control` command will run the gui application.
### Keybindings
| Keybinding | Action |
|------------|--------|
| `Shift + S` | Open Settings Dialog |
| `Q` or `Ctrl + Q` | Quit Application |
## 💾 Installation
🏗️ Arch-based Distributions
```bash
yay -S better-control-git
```
> This will directly install dependencies and the app. No further steps required.
❄️ Nix (Unofficial)
> This is an unofficial Nix flake maintained by the community. All issues should be directed to their repository:
>
> https://github.com/Rishabh5321/better-control-flake
🐧 Debian-based Distributions
```bash
sudo apt update && sudo apt install -y libgtk-3-dev network-manager bluez bluez-utils pulseaudio brightnessctl python3-gi python3-dbus python3 power-profiles-daemon gammastep python3-requests python3-qrcode
```
🎩 Fedora-based Distributions
```bash
sudo dnf install -y gtk3 NetworkManager bluez bluez-utils pulseaudio brightnessctl python3-gobject python3-dbus python3 power-profiles-daemon gammastep python3-requests python3-qrcode
```
🌀 Void Linux
```bash
sudo xbps-install -S gtk3 NetworkManager bluez bluez-utils pulseaudio brightnessctl python3-gobject python3-dbus python3 power-profiles-daemon gammastep python3-requests python3-qrcode
```
🏔️ Alpine Linux
```bash
sudo apk add gtk3 networkmanager bluez bluez-utils pulseaudio brightnessctl py3-gobject py3-dbus python3 power-profiles-daemon gammastep py3-requests py3-qrcode
```
### Manual Installation Steps
```bash
git clone https://github.com/quantumvoid0/better-control.git
cd better-control
make
sudo make install
```
## 📚 Documentation
For more information, please refer to the [official documentation](https://github.com/quantumvoid0/better-control/wiki).
## 📄 License
This project is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) file for more details.
## 🗑️ Uninstallation
🏗️ Arch-based Distributions
```bash
yay -Rns better-control-git
```
📦 Other Distributions
```bash
git clone https://github.com/quantumvoid0/better-control
cd better-control
sudo make uninstall
```
## 🧪 Compatibility Matrix
Better-Control has been tested on Arch Linux with Hyprland, GNOME, and KDE Plasma. It should work on most Linux distributions with minor adjustments.
Category
Compatibility
Operating System
Linux
Distributions
Arch-based ✓ • Fedora-based ✓ • Debian-based ✓ • Void ✓ • Alpine ✓
Desktop Environments
GNOME (tested) ✓ • KDE Plasma (tested) ✓ • XFCE • LXDE/LXQT
Window Managers
Hyprland (tested) ✓ • Sway (tested) ✓ • i3 • Openbox • Fluxbox
Display Protocol
Wayland (recommended) ✓ • X11 (partial functionality)
> [!NOTE]
> If you test Better-Control on a different setup, please share your experience in the discussions or issues section.
### Made with ❤️ for the Linux community
[Report Bug](https://github.com/quantumvoid0/better-control/issues) •
[Request Feature](https://github.com/quantumvoid0/better-control/issues) •
[Contribute](https://github.com/quantumvoid0/better-control/pulls)