GNOME Tweaks provides a central interface for adjusting hidden settings in the GNOME desktop environment that the standard Settings application does not expose. You can install GNOME Tweaks on Debian 13, 12, and 11 from the default repositories using APT, then use it to change fonts, customize window title bar buttons, enable click-to-minimize on the dock, and manage shell extensions.
GNOME Tweaks requires the GNOME desktop environment. If you are running Xfce, KDE Plasma, Cinnamon, LXQt, or another desktop environment, this tool will not function properly. GNOME Tweaks is not available as a Flatpak because it requires deep integration with the system-level GNOME Shell configuration that Flatpak sandboxing prevents.
Update Debian Before Installing GNOME Tweaks
Update your package index and upgrade any outdated packages before installing new software. This ensures APT can locate the correct package versions and that your system has the latest security patches.
sudo apt update && sudo apt upgradeIf your user account does not have sudo privileges, see our guide on adding a user to sudoers on Debian.
Install GNOME Tweaks on Debian via APT
Install GNOME Tweaks from the default Debian repositories. The package name is gnome-tweaks on all current Debian releases, replacing the older gnome-tweak-tool name used in previous versions.
sudo apt install gnome-tweaksAPT resolves all required dependencies automatically. After installation completes, verify that GNOME Tweaks is accessible by checking the installed version:
gnome-tweaks --versionExpected output on Debian 13:
46.1
The version number varies by Debian release. Debian 13 includes version 46.x, Debian 12 includes version 42.x, and Debian 11 includes version 3.34.x. Core customization features work consistently across all releases, though some newer panels are only available in recent versions.
Launch GNOME Tweaks on Debian
Once installed, you can launch GNOME Tweaks from the terminal or through the GNOME Activities overview. Both methods open the same application.
Launch from Terminal
To start GNOME Tweaks from a terminal session, run the following command:
gnome-tweaksThe application window opens immediately. You can close the terminal afterward without affecting the running application.
Launch from Applications Menu
To access GNOME Tweaks through the graphical interface:
- Click Activities in the top-left corner to open the overview.
- Type
Tweaksin the search bar. - Click the Tweaks icon when it appears in the search results.
Customize Debian Desktop with GNOME Tweaks
GNOME Tweaks organizes its settings into categories accessible from the left sidebar. Each category controls a specific aspect of your desktop environment, and the following sections highlight the most commonly used customization options.
Appearance and Themes
The Appearance panel lets you customize visual elements including the application theme, icon set, cursor style, and shell theme. You can install themes from the Debian repositories or download them from GNOME Look and apply them here.
Fonts
The Fonts panel controls the typefaces used throughout the desktop, including the interface font, document font, monospace font for terminals, and window title font. The scaling factor adjusts text size system-wide without changing individual font settings. To expand your font options, see our guide on installing Microsoft fonts on Debian.
Extensions Management
The Extensions panel displays installed GNOME Shell extensions and provides toggles to enable or disable each one. You can also access individual extension settings from this panel. Installing new extensions requires the GNOME Shell Extensions browser integration or manual installation from extensions.gnome.org.
Window Behavior
The Windows panel controls how windows behave when opened, focused, or interacted with. Key options include:
- Titlebar Actions: Configure what happens when you double-click or middle-click a window title bar (maximize, minimize, or show menu).
- Titlebar Buttons: Add minimize and maximize buttons to window title bars, which GNOME hides by default.
- Focus Mode: Choose whether clicking a window or simply hovering over it brings it to focus.
Keyboard and Mouse
The Keyboard & Mouse panel provides options for pointer acceleration, touchpad behavior, and keyboard layout adjustments not available in the standard Settings application.
Top Bar
The Top Bar panel controls what appears in the GNOME panel at the top of your screen. You can toggle the Activities button, show or hide the clock and calendar, enable weekday display in the date, and configure battery percentage visibility on laptops.
Startup Applications
The Startup Applications panel shows programs configured to launch automatically when you log in. You can add new applications or remove existing ones to streamline your login process and reduce boot time.
Troubleshoot GNOME Tweaks on Debian
Application Fails to Launch
If GNOME Tweaks fails to open or closes immediately after launching, verify that you are running the GNOME desktop environment. Check your current session type with:
echo $XDG_CURRENT_DESKTOPExpected output for GNOME:
GNOME
If the output shows something else (such as KDE, XFCE, or LXQt), GNOME Tweaks will not function correctly. The tool requires GNOME Shell and its associated services to operate.
Shell Theme Option Grayed Out
If the Shell theme option appears grayed out in the Appearance panel, install the User Themes extension to unlock it. The package name varies by Debian version.
Debian 13 (Trixie):
sudo apt install gnome-shell-extension-user-themeDebian 11 and 12:
sudo apt install gnome-shell-extensionsAfter installation, log out and log back in for the extension to load. Open GNOME Tweaks, navigate to the Extensions panel, and enable the User Themes extension. The Shell theme option in the Appearance panel becomes active after enabling this extension.
Remove GNOME Tweaks from Debian
If you no longer need GNOME Tweaks, remove the package along with any unused dependencies:
sudo apt remove gnome-tweaksRemove orphaned packages that were installed as dependencies but are no longer required:
sudo apt autoremoveRefresh the package index and verify removal:
sudo apt update && apt-cache policy gnome-tweaksExpected output after removal:
gnome-tweaks:
Installed: (none)
Candidate: x.x.x
Version table:
x.x.x 500
500 http://deb.debian.org/debian [codename]/main amd64 Packages
Frequently Asked Questions
No. GNOME Tweaks is not available on Flathub. The application requires direct access to system-level GNOME Shell configuration files and D-Bus interfaces that Flatpak sandboxing prevents. Install it through APT with sudo apt install gnome-tweaks instead.
GNOME Settings handles standard preferences like display resolution, network connections, and user accounts. GNOME Tweaks exposes hidden options that Settings does not include, such as font scaling, window title bar button layout, shell theme selection, and startup application management.
Yes. GNOME Tweaks works under both Wayland and X11 sessions on Debian. Most options function identically on both display servers, though some third-party GNOME Shell extensions may behave differently under Wayland.
GNOME Tweaks does not include a built-in reset button. To restore defaults, run dconf reset -f /org/gnome/desktop/ to clear desktop customizations and dconf reset -f /org/gnome/shell/ to clear shell settings. Log out and back in for all changes to take effect.
Conclusion
You now have GNOME Tweaks installed on Debian and can customize appearance themes, fonts, window title bar buttons, and shell extensions beyond what the default Settings application exposes. Start with the Appearance panel to apply a custom theme, then adjust startup applications and top bar visibility to match your workflow.
Formatting tips for your comment
You can use basic HTML to format your comment. Useful tags currently allowed:
<code>command</code>command<strong>bold</strong><em>italic</em><blockquote>quote</blockquote>