A lightweight graphical utility using Zenity for seamless visual management (install, reinstall, remove) of local Debian (.deb) packages.
Deb-progress-installer brings full package lifecycle management to your desktop by wrapping native, robust backend systems (apt and dpkg) into a clean, modern user interface.
- 📥 Seamless Local Installation: Easily install any local
.debpackage without manually opening a terminal. The tool safely intercepts administrative hooks to resolve and download missing system dependencies automatically. - 🔄 Quick Reinstallation: If the application is already on your system, the interface automatically detects it and provides an option to force a clean reinstallation—perfect for fixing broken binaries or resetting software states.
- ❌ Clean Uninstallation / Removal: No need to jump into a separate app store or run terminal commands to delete software. If the package is present, you can choose to purge and remove it completely right from the prompt.
- 📊 Real-Time Progress Tracking: Translates dense terminal status lines into a smooth, readable graphical progress bar using
Zenity, providing terminal-free visual feedback. - 🧠 Dynamic System Audits: Simulates package layouts before executing any changes to alert you of potential system conflicts or dependency errors before they occur.
Traditional GUI installers used to be the go-to standard, but they've been abandoned for years. Running that legacy code on modern systems like Ubuntu 26.04 frequently leads to frustrating freezes and crashes. To make matters worse, official Software Centers have become sluggish and bloated, often trying to force-feed users Snaps instead of just handling a simple local .deb file.
You can install the package directly without needing to manage external repositories. This works perfectly on Ubuntu, Debian, and all major derivative distributions:
- Click the Download .deb Installer badge above to go to the latest release page.
- Click on the
.debfile under the Assets section to download it. - Double-click the downloaded file in your Downloads folder to launch your system's default Software Store, then click Install.
If you prefer the command line, copy and paste this single command. It queries the GitHub API to dynamically fetch the latest versioned package, downloads it safely to your temporary directory, and configures all required system dependencies automatically:
wget -O /tmp/installer.deb $(curl -s [https://api.github.com/repos/cybermaxpower/deb-progress-installer/releases/latest](https://api.github.com/repos/cybermaxpower/deb-progress-installer/releases/latest) | grep -o 'https://[^"]*\.deb' | head -n 1) && sudo apt install /tmp/installer.deb && rm /tmp/installer.deb
Once installed, you need to tell your file manager to use this tool to open Debian packages. You only have to do this once!
- Find any
.debfile on your computer (for example, in your Downloads folder). - Right-click the
.debfile. - Select Open With Other Application (or Properties -> Open With, depending on your desktop layout).
- Look through the list and select Deb Progress Installer.
- Click the Set as Default button.
From now on, simply double-click (or right-click -> Open With -> Deb Progress Installer) any local .deb file.
The installer will run a quick background audit and automatically adapt to your system's state:
- 📥 New Installation: If the app isn't on your system yet, the installer will immediately fetch any missing dependencies and show you a clean, real-time visual progress bar.
- 🔄 Reinstall or Remove: If the exact same version of the app is already installed, a graphical menu will prompt you to choose between:
- Reinstall: Forces a clean reinstall of the package (perfect for fixing corrupted app states).
- Remove: Completely purges the application from your system.
- 🧠 Smart Upgrade: If you open a
.debfile that is newer than your currently installed version, the app automatically runs a seamless upgrade, keeping your data intact without forcing a manual uninstall first.
Standard command-line tools like dpkg don't natively provide a graphical progress readout, which can leave desktop users wondering if an installation is stuck.
deb-progress-installer acts as an intelligent, lightweight wrapper that bridges the gap between the Debian package management backend and the desktop environment.
- A GUI-First Experience: Unlike CLI utilities like
deb-get—which focus on downloading popular third-party software from the terminal—deb-progress-installeracts as a native desktop mouse-click handler. It is designed for those who just want to double-click a local file in their file manager. - Granular Progress Tracking: Standard command-line tools often hide what they are doing behind dense text walls. This tool uses a clean, visual Zenity progress bar that parses the installation frame-by-frame, tracking granular stages like data unpacking, dependency resolution, and real-time backend configuration so you are never left guessing if your installation is stuck.
deb-progress-installer fills this gap perfectly: a dead-simple, blazing-fast, and reliable native tool that does one thing and does it well—installing your local packages with beautiful, real-time graphical progress tracking without any of the baggage.
- Root Privilege Handling: The application leverages
pkexecorsudoto securely elevate privileges, ensuring safe package execution. - Terminal Parsing: It triggers a non-interactive
dpkginstallation process and actively intercepts the standard output (stdout) streams. - Regex Status Filtering: The core script monitors specific packaging triggers, such as unpacking, setting up, and configuring dependencies.
- Zenity UI Generation: It parses those terminal triggers in real-time, instantly converting raw text percentages into a smooth, native GTK graphical progress bar via
zenity.
Q: The installer window is transparent, has weird border lines, or is hard to read. How do I fix this?
A: Starting in version 1.1.5, the installer completely defers to your system's native GTK theme and compositor settings rather than forcing its own styles. If the window looks glitched, it is usually due to how your desktop compositor (like Picom, Compton, or your desktop's built-in window manager) is rendering transparency.
You can easily resolve this on your system in a couple of ways:
- Adjust Compositor Opacity: Check your compositor configuration files or system window settings. Ensure that "inactive window opacity" or "override redirect" rules aren't accidentally forcing Zenity windows to be transparent.
- Switch/Update Your Theme: Some older custom X11 themes don't supply the proper background color values to GTK applications. Temporarily switching to a standard theme (like Adwaita, Yaru, or Breeze) will instantly verify if the issue is theme-specific.
A: Yes! If your system's hardware acceleration is struggling with GTK rendering, you can force the application to use the classic, lightweight 2D Cairo renderer.
Just launch the installer from your terminal with the Cairo renderer environment variable set:
GSK_RENDERER=cairo deb-progress-installer /path/to/your/package.deb
This software application is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are completely disclaimed. In no event shall the developer or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.
- System-Wide Access: Unlike sandboxed container formats (such as Flatpak or Snap), this tool handles native Debian (
.deb) packages. These packages are extracted and executed system-wide using elevated administrative privileges (pkexec). Running installations through this frontend will directly alter core system directories, modify shared infrastructure libraries, and manipulate your base operating system configuration. - Purge Operations: Utilizing the "Remove (Uninstall)" feature executes a complete system purge (
apt-get purge). This process will permanently delete system-wide configuration files and local assets associated with that package.
The end-user assumes absolute and full responsibility for any software operations, updates, or removals executed using this application frontend.
Because native package management interacts directly with the core operating system layer, you must carefully verify the source, integrity, and dependency requirements of any .deb file before confirming administrative authentication. The author holds no liability or responsibility for broken system packages, unresolved dependency conflicts, accidental software removal, or any misuse of this scripting automation.