https://github.com/better-ecosystem/better-control
A simple control panel for linux based on the GTK framework
https://github.com/better-ecosystem/better-control
control gtk linux python settings
Last synced: 20 days ago
JSON representation
A simple control panel for linux based on the GTK framework
- Host: GitHub
- URL: https://github.com/better-ecosystem/better-control
- Owner: better-ecosystem
- License: gpl-3.0
- Created: 2025-03-11T08:21:38.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-02T17:48:48.000Z (about 1 month ago)
- Last Synced: 2025-06-03T01:34:49.479Z (about 1 month ago)
- Topics: control, gtk, linux, python, settings
- Language: Python
- Homepage: https://github.com/quantumvoid0/better-control/blob/main/README.md#-installation
- Size: 7.97 MB
- Stars: 286
- Watchers: 6
- Forks: 20
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.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/better-ecosystem/better-control/stargazers)
[](https://github.com/better-ecosystem/better-control/releases/latest)
---
> [!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 and tons of features
- 🌙 Respects your system's light/dark theme settings
- 🧩 Modular design - use only what you need and remove the ones you don't use (see dependencies for more info)
Dependencies
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, python-setproctitle |
### 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 |
| **USBGuard** | USBGuard |
| **Pillow** | For QR Code on Wi-Fi |
> [!TIP]
> If you don't need a specific feature, you can safely omit its corresponding dependency and hide its tab in the settings.
---
## 💾 Installation & Uninstallation
### 🚀 Quick Install (Recommended)
The easiest way to install Better Control is using our automated installer script:
```bash
bash <(curl -s https://raw.githubusercontent.com/better-ecosystem/better-control/refs/heads/main/betterctl.sh)
```
**What this script does:**
- Uses [AUR](https://aur.archlinux.org/packages/better-control-git) for Arch-based distributions
- Uses [Makefile](https://github.com/better-ecosystem/better-control/blob/main/Makefile) for other distributions
- Automatically installs all required dependencies
> [!TIP]
> **Security conscious?** You can review the installer script [here](https://raw.githubusercontent.com/better-ecosystem/better-control/refs/heads/main/betterctl.sh) before running it.
**Supported Distributions:**
- 🔵 Arch-based (Arch, Manjaro, EndeavourOS, etc.)
- 🟠 Debian-based (Ubuntu, Linux Mint, Pop!_OS, etc.)
- 🔴 Fedora-based (Fedora, openSUSE, etc.)
- 🟢 Void Linux
- 🏔️ Alpine Linux
### 🔧 Manual Installation
For users who prefer manual installation or need more control over the process:
```bash
git clone https://github.com/better-ecosystem/better-control
cd better-control
sudo make install
```
**For Arch Linux users**, Better Control is also available on the AUR:
```bash
yay -S better-control-git
```
> [!IMPORTANT]
> When building manually, ensure you have all [dependencies](#dependencies) installed beforehand.
➡️ Nix/NixOS (Distro Independent) (Unofficial)
Better Control is available in the `nixpkgs` repository.
**On NixOS:**
```bash
nix-env -iA nixos.better-control
```
**On Non-NixOS:**
```bash
# without flakes:
nix-env -iA nixpkgs.better-control
# with flakes:
nix profile install nixpkgs#better-control
```
⚠️ **Bleeding edge (Unstable):** This flake will update to the latest commit automatically: [Better Control Flake](https://github.com/Rishabh5321/better-control-flake)
### 🔄 Updates & Uninstallation
After installation, you can manage Better Control using the `betterctl` command:
```bash
betterctl # Interactive menu for update/uninstall options
```
---
## 🫴 Usage
Use the `control` or `better-control` command to run the GUI application. Use `control --help` or `better-control --help` to see more specific launch commands you can use with tools like waybar.
You can use `betterctl` to update or uninstall the application.
### Keybindings
| Keybinding | Action |
|------------|--------|
| `Shift + S` | Open Settings Dialog |
| `Q` or `Ctrl + Q` | Quit Application |
---
## 📚 Contribution
If you want to contribute, see [CONTRIBUTING.md](https://github.com/better-ecosystem/better-control/blob/main/CONTRIBUTING.md)
## 📄 License
This project is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) for more details.
---
## 🧪 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/better-ecosystem/better-control/issues) •
[Request Feature](https://github.com/better-ecosystem/better-control/discussions) •
[Contribute](https://github.com/better-ecosystem/better-control/tree/main?tab=readme-ov-file#--contribution)