ArchLinux Tweak Tool (ATT)
A comprehensive, user-friendly graphical application for customizing and maintaining Arch-based Linux systems. ATT provides an intuitive interface to manage system configurations, themes, packages, and services without requiring command-line expertise.
Installation
Add the nemesis_repo to your /etc/pacman.conf and update your system.
[nemesis_repo]
Server = https://erikdubois.github.io/$repo/$arch
nemesis_repo is PGP-signed by the Kiro key (trusted via kiro-keyring); it
inherits your global SigLevel. Adding it by hand before the keyring is present?
Use SigLevel = Optional for the repo until then.
or you can use this script download it and run it
curl -sL bit.ly/nemesis-repo | sudo bash
Then install
sudo pacman -S archlinux-tweak-tool
Gallery
Application Screenshots
Overview
ArchLinux Tweak Tool (ATT) is a GTK4-based desktop application designed to simplify system administration and customization for Arch-based Linux distributions. Originally developed for ArcoLinux, ATT now supports numerous Arch-based systems and provides a unified interface for managing various aspects of your Linux system through a graphical user interface.
The tool is written in Python with GTK4 and is built with extensibility and user-friendliness in mind, allowing both novice and experienced users to manage their systems efficiently.
Key Features
🖥️ Desktop Management
- Install and switch desktop environments (KDE, GNOME, Xfce, Hyprland, dwm, and more)
- Supports X11 and Wayland sessions
- Desktop environment-specific configuration
⚙️ Kernel Management
- Install and remove kernels with a single click
- Supports mkinitcpio and dracut initramfs generators
- GRUB boot entry integration
- View currently running kernel and all installed options
🎬 Boot Splash (Plymouth)
- Install and switch Plymouth boot splash themes
- Bootloader integration for systemd-boot, GRUB, limine, and rEFInd
- Dracut and mkinitcpio hook configuration
- Fix initramfs hooks directly from the UI
🔑 Login Manager (SDDM)
- Install and preview SDDM themes
- Configure cursor, wallpaper, session, and display settings
- Sort available themes by recently updated (AUR)
- Fix and apply SDDM configuration
💻 Shell Configuration
- Switch default shell between bash, zsh, and fish
- Configure shell environments and themes
- Zsh plugin and theme management
🤖 AI Tools
- Claude AI integration for system assistance
- AI-powered help for system configuration and troubleshooting
🔒 Privacy & Security
- hBlock integration for DNS-based ad blocking
- Privacy-focused system configuration
🔍 System Inspector
- Hardware information overview
- Running services and system journal at a glance
- Real-time system profile
🛠️ Software Installers
- Curated installers for commonly used applications
- One-click setup for popular tools and utilities
🖼️ Wallpaper Management
- Browse folders and set desktop wallpapers
- Supports all major desktop environments and window managers
🎨 Appearance & Themes
- Install and manage GTK and Plasma themes
- Configure icon themes
- Apply coordinated theme sets (GTK + icons + cursor + wallpaper)
📦 Package Management
- Export and import installed package lists
- Batch package installation from saved configurations
- Pacman configuration, repo management, and parallel downloads
🔧 System Configuration
- Services: Enable/disable systemd services
- Autostart: Manage applications that launch at login
- User Management: Create and configure user accounts
- Locale: Set locale, keyboard layout, and timezone
🚀 Performance & Optimization
- CPU governor and I/O scheduler tuning
- System performance settings
- Resource utilization optimization
🧹 System Maintenance
- Clear orphaned packages
- Find and set best pacman mirrors
- Remove pacman lock files
- System cleanup utilities
📊 Logging & Information
- FastFetch configuration for system information display
- ATT session log browser
- Network tools and Samba share configuration
Supported Distributions
ATT originally developed for ArcoLinux, now supports numerous Arch-based distributions:
Note: The complete and up-to-date list of supported distributions is maintained in the source code at the beginning of archlinux-tweaktool.py file, as new distributions are regularly added during development.
Pages & Tabs
ATT currently has 24 tabs (sidebar pages):
| Tab | Contents |
|---|
| AI Tools | Claude AI integration for system assistance |
| Arc themes | Standalone Arc GTK and Plasma theme management |
| Autostart | Manage applications that launch at login |
| Desktop | Install and switch desktop environments (KDE, GNOME, XFCE, Hyprland, dwm, and more) |
| Fastfetch | Configure fastfetch system-info display and presets |
| Icons | Install and manage icon themes |
| Kernels | Install and remove kernels; GRUB and dracut/mkinitcpio integration |
| Locale | Set locale, keyboard layout, and timezone |
| Logging | Browse ATT session logs and system journal entries |
| Maintenance | Mirror ranking, orphan package removal, pacman cache cleanup, lock-file removal |
| Network | Network tools and Samba share configuration |
| Packages | Export and import installed package lists; batch installation from saved configs |
| Pacman | pacman.conf settings, repo management, and parallel downloads |
| Plymouth | Boot splash theme installation and configuration (mkinitcpio and dracut) |
| Privacy | hBlock DNS ad-blocking and privacy-focused system settings |
| Performance | CPU governor, I/O scheduler, and system performance tuning |
| Sddm | SDDM login manager — themes, cursor, wallpaper, session and display config |
| Services | Enable and disable systemd services |
| Shells | Switch default shell; configure bash, zsh, and fish environments |
| Software | Curated software installers for common applications |
| System | System inspector — hardware info, running services, journal overview |
Desktop Environment Support
ATT works with virtually all Arch-based desktop environments, including:
- X11 Desktop Environments: KDE Plasma, GNOME, Xfce, LXQt, MATE, Cinnamon, and others
- Wayland Desktop Environments: Hyprland, Sway, GNOME (Wayland), KDE Plasma (Wayland), and others
System Management & Backup
ATT implements automatic backup functionality for system safety:
- Configuration file changes are backed up with
.bak or .back extensions
- Reset buttons utilize backup files to restore previous configurations
- Manual backups can be created before major changes
Advanced Configuration
Login Manager Configuration
ATT provides specialized configuration tools for common login managers:
- SDDM: Simple Display Manager configuration
Automated fix scripts are available if issues occur:
Repository Management
ATT allows you to configure additional package repositories, but caution is recommended as incompatible repositories can cause system conflicts. Always review repository settings carefully before enabling them.
Languages
ATT is available in English, Dutch, German, Spanish, French, Brazilian Portuguese, Italian, Russian, Hungarian,
Turkish, Polish, Japanese, Simplified Chinese and Romanian. It follows your system language. To pick another one,
use the language dropdown in the header, next to ♥ Support, then click Restart ATT. The choice is saved for
later starts. Logs stay in English.
Translations live in po/ as gettext catalogs. Corrections are welcome in
Discussions.
Requirements
- Operating System: Arch Linux or Arch-based distribution
- Python: Python 3.x
- GUI Library: GTK 4.0
- Package Manager: pacman
Installation
Detailed installation instructions are available in the project's documentation or can be found in the respective distribution's repository.
Support & Documentation
Authors
- Brad Heffernan
- Erik Dubois
- Cameron Percival
Contributing
Contributions are welcome! If you encounter issues or want to add support for additional distributions or features, please:
- Check the GitHub repository for existing issues
- Create a detailed bug report or feature request
- Submit pull requests with improvements
Help fund Kiro
Everything I build here stays free and open — always. If Kiro or any of these
tools have ever saved you time or taught you something, a small monthly
contribution helps keep the work going. Donations target break-even, nothing
more — the core always stays free for everyone.
License
Please refer to the LICENSE file in the repository for licensing information.
Note: This tool requires administrative privileges (sudo/pkexec) to modify system configurations. Always ensure you understand the changes being made to your system configuration.
