MintApp_Remover

MintApp Remover icon

MintApp Remover

Uninstaller and cleaner for Linux, in English and Spanish.
A single Bash script that shows you exactly what it will remove before it removes it.

English · Español

GPLv3 license Bash 4.3 or newer English and Spanish


What’s new

Version 2.2.0:

What it is

A small tool for two jobs, both without surprises: removing programs in an orderly way, and cleaning what a system accumulates (caches, logs, temporary files, traces of use).

A fresh Linux installation always has a few programs you will never use. Removing them by hand means knowing the exact package name (which rarely matches the name in the menu) and trusting that the removal will not take something along that it should not. MintApp Remover solves both: it gives you a checklist of the applications and, before removing anything, shows you the real result of the operation.

The cleaning works in the style of BleachBit, with defaults chosen to be safe: two levels (the simple one has age limits), nothing is deleted before you see what and how much, the default answer is “no”, and the trash, which cannot be undone, is never marked for you. See Option 4 below.

It is not an “optimizer” and it does not promise miraculous gigabytes.

Screenshots

Version 2.2.0 on Linux Mint 22.3 with apt. The program works in the terminal by default and in windows when you press G (or when it starts without a terminal).

Main menu in the terminal
The main menu in the terminal. The first line says what the program found: the system, the package manager and how many catalog applications are installed.

Main menu in windows
The same menu in windows (`zenity`). `T` goes back to the terminal.

Advanced mode in windows
Option 3, advanced mode, in windows: applications found from the menu launchers, each with its package. Flatpak ones show their ID.

Preview of the deep cleanup in windows
Option 4, deep cleanup (complete level), in windows. Before anything is deleted, the list shows what would be cleaned, where and how much. The default answer is `Cancel`.

Advanced mode in the terminal
Option 3 in the terminal: the same list. The last row lists the keys that work on the screen.

Deep cleanup in the terminal
Option 4, deep cleanup, in the terminal: what the level cleans and, below, what you want to clean: the whole level, by category or one by one.

Advantages

Most scripts of this kind that circulate on forums are a fixed list of sudo apt purge package1 package2 package3.... If a package name changed between releases, or you have something installed that the author never considered, you are left halfway or, worse, you trust a list you did not review.

MintApp Remover does it differently:

Compatibility

The requirement is bash 4.3 or newer plus the tools of one supported package manager. The program checks them at start and says what is missing.

Level System Status
1 Debian, Ubuntu and derivatives (Linux Mint, Pop!_OS, Zorin, MX Linux, elementary OS…), with apt and dpkg Supported and tested
2 Flatpak and Snap applications, on any of the systems here Detected in Option 3; removal with plan, confirmation and record
3 Fedora, RHEL and derivatives (dnf 4 and rpm), Arch and derivatives (pacman), openSUSE and derivatives (zypper) Supported and tested
— Alpine, Void, Gentoo, BSD, macOS and other managers (apk, xbps, nix, emerge) Out of scope

About level 3:

The catalog of Option 2 depends on your desktop. The program reads your distribution and desktop (/etc/os-release, XDG_CURRENT_DESKTOP) and does not name them in its interface:

Desktop Entries in the catalog
Cinnamon (Linux Mint) 25
GNOME / Ubuntu 43
KDE Plasma 30
XFCE 44
MATE 32
Not recognized all 110

An application whose packages are not installed is never shown, so a long list does not mean a long result. Option 3 is the portable part: it relies on a scan of the launchers, not on a fixed list, and each desktop has its own list of system components it leaves out.

Installation

You need bash and one supported package manager. Nothing else: zenity (windows) and whiptail are optional.

Clone the repository or download the ZIP:

git clone https://github.com/Filonux/mintapp_remover.git
cd mintapp_remover
chmod +x script/MintApp_Remover.sh
./script/MintApp_Remover.sh

To keep it as a command with a menu launcher and an icon, run the same file with install:

./script/MintApp_Remover.sh install

This needs no sudo and writes only in your own folders:

What Where
Command mintapp-remover ~/.local/bin/
Menu launcher $XDG_DATA_HOME/applications/mintapp-remover.desktop (~/.local/share/... by default)
Icon $XDG_DATA_HOME/icons/hicolor/512x512/apps/mintapp-remover.png

Running it again repairs or updates what changed and leaves the rest alone. If ~/.local/bin is not in your PATH, the program tells you the line to add. Without zenity the launcher opens a terminal, since there would be nothing else to show.

Run it as a normal user, not with sudo in front: it asks for administrator rights only at the moment it really has to change something. It uses sudo or, if sudo is missing, doas.

Usage

MintApp_Remover.sh [OPTION]
MintApp_Remover.sh install
MintApp_Remover.sh uninstall [DATA]

  -h, --help       Show the help and exit.
  -V, --version    Show the version and exit.
  --gui            Open the windows (zenity), even on a terminal.
  --terminal       Use the terminal; never open windows.
  --show-help      Show the key help again, even if you have seen it.
  install          Install the command, the menu launcher and the icon.
  uninstall        Remove them and ask what to do with your settings and
                   removal records. DATA skips the question:
                     --keep-records  delete the settings, keep the records
                     --keep-all      keep both
                     --purge         delete both, leaving no trace

Without a terminal (for example from the launcher) and with zenity, it opens the windows, unless your last choice was the terminal (T): then it opens a terminal emulator with the program.

On start, the first screen explains how to move around (shown once, until you ask for it again with --show-help). In short:

Key Action
↑ ↓ Move through the list, wherever the focus is
Home End · PgUp PgDn First or last entry · one page at a time
Space Mark or unmark an application; in a menu, choose the entry
A / N Mark or unmark everything the list shows
Enter Press the highlighted button
Esc or Q Go back or cancel
/ Search long lists
Tab Optional: switch to the buttons (← → work too)
1 2 3 4 L G T 0 In the main menu, each key opens its option (G and T appear only when they apply)

The last row of the screen always lists the keys that work on that screen.

The main menu:

1. Detect applications
2. Uninstall applications
3. Find other applications (advanced)
4. Clean up
G. Graphical menu        (only if zenity and a graphical session are available)
T. Back to terminal      (only in the windows, when a terminal can be opened)
L. Español
0. Exit

1 · Detect applications

Checks the catalog of your desktop (see Compatibility; the full list is the CATALOG_ALL array in the script) and shows only the applications that are installed, with their package, version and size. It is a diagnostic step: it removes nothing.

2 · Uninstall applications

Runs the detection if it has not been done yet and shows the result as a checklist. Once you confirm the plan of the package manager it removes the selected packages, configuration files included where the manager can (apt purge; see the notes on dnf above). The search (/) ignores case and accents and looks at name, description and package.

3 · Find other applications (advanced)

The mode that does not depend on the fixed catalog. It scans /usr/share/applications, ~/.local/share/applications and the folders where Flatpak and Snap export their launchers, identifies each launcher visible in the menu and asks the package manager which package it belongs to. It then discards automatically:

Flatpak and Snap applications are listed with the packages and removed after their own plan: flatpak uninstall (system or user installation, as found) and snap remove. Each one is removed on its own, so one that fails does not stop the rest. Launchers it cannot manage (an installation by hand, a Flatpak or Snap it cannot identify, or a file claimed by more than one package) are listed apart, labeled with their origin: [Flatpak], [Snap], [manual install] or the name of the manager.

Even with all these filters, the real plan is always shown before removing, and a plan that would drag meta-packages gets a warning and a stronger question. This is the mode meant to find third-party applications, desktop extensions that came as packages, or software you installed yourself and no longer use.

4 · Clean up

A cleaner in the style of BleachBit with safe defaults, not only a dependency remover. Two actions:

Clean up dependencies removes the dependencies that are no longer needed (apt autoremove or the equivalent of your manager), after showing you the plan, and cleans the cache of downloaded packages. It shows an approximate figure of the space recovered.

Deep cleanup deletes waste files, caches, logs and traces of use. You choose the level, then the scope (the whole level, whole categories, or item by item). Before anything is deleted you see what is cleaned and how much space it frees, and you confirm. The defaults protect you: the confirmation starts on “no”, item by item everything starts marked except the trash (which you must mark yourself), and by category nothing starts marked.

Category Item Simple Complete Admin
Privacy Recent documents lists ✓ ✓  
  Clipboard (needs xsel, xclip or wl-copy) ✓ ✓  
  Trash (permanent)   ✓  
Caches Thumbnails ✓ ✓  
  Browser caches (Firefox, Chrome, Chromium, Brave, Opera, LibreWolf, Thunderbird; open ones are skipped) ✓ ✓  
  ~/.cache ✓ ✓  
  Flatpak and Snap application caches ✓ ✓  
  Your files in /tmp and /var/tmp that are not in use ✓ ✓  
Logs Rotated system logs (.1, .gz, .old) ✓ ✓ ✓
  systemd journal ✓ ✓ ✓
  ~/.xsession-errors   ✓  
  Crash reports and memory dumps   ✓ ✓
Packages (apt only) Downloaded .deb files ✓ ✓ ✓
  Settings of packages already removed   ✓ ✓

How it works

A typical session, step by step:

  1. Run ./script/MintApp_Remover.sh. Read the first screen and press Enter.
  2. Press 2. The list shows what is installed. Move with ↑ ↓, mark with Space, or press / to search. Confirm with Enter on OK.
  3. The program calculates the removal with the package manager and shows the real plan, with every package that would go. Nothing has changed yet.
  4. Confirm. The default answer is Cancel, so an accidental Enter removes nothing.
  5. The plan is checked once more; only then does the program ask for your password (or, with dnf, it already did) and run the removal.
  6. When it ends you get the result and the path of the record file. Then use Option 4 to clean leftover dependencies.

Advanced configuration

All optional. Environment variables:

Variable Effect
MINTAPP_UI=tui\|gui\|whiptail\|text Force the built-in dialogs (default on a terminal), the windows (zenity), whiptail or the plain-text menu. Without zenity or a graphical session, gui falls back to the default. --gui and --terminal win over it.
MINTAPP_TERMINAL=name\|path Terminal emulator that T opens from the windows, and that the launcher opens when your last choice was the terminal. By default, the first one found: x-terminal-emulator, gnome-terminal, konsole, xfce4-terminal, mate-terminal, lxterminal, qterminal, terminator, alacritty, kitty, xterm. One you name that cannot be run is an error, never a silent fallback.
MINTAPP_LANG=en\|es Force the interface language instead of detecting it.
MINTAPP_PM=apt\|dnf\|pacman\|zypper Force the package manager. Any other value is an error, never a silent fallback. By default it is the one of your distribution, else the first one found.
MINTAPP_ESC_WAIT=0.15 Seconds to wait after Esc before taking it as the key itself (raise it on a slow SSH link).
MINTAPP_LAUNCHER_DIRS=dir1:dir2 Scan only these folders in Option 3.
MINTAPP_SUDO=sudo\|doas\|path Command used to get administrator rights.
NO_COLOR=1 No colors (also with TERM=dumb or fewer than 8 colors).
MINTAPP_ASCII=1\|0 Plain ASCII (1) or Unicode symbols (0). By default ASCII is used when the locale is not UTF-8.

Files the program writes (all private to your user, written atomically):

Key Values Saved when
interface terminal, gui You switch with G or T
language es, en You switch with L
help_seen yes, no You have seen the first screen

Uninstalling the program

If you installed it with install:

mintapp-remover uninstall

It removes the command, the launcher and the icon, and asks what to do with your settings and removal records (keep the records if you want the reinstall commands of past removals). To skip the question add --keep-records, --keep-all or --purge (everything, leaving no trace). It only removes what it installed and leaves alone anything else it finds in those places.

If you only ran it from the folder you cloned, delete the folder and, if you want, what it wrote:

rm -r ~/.local/state/mintapp-remover ~/.config/mintapp-remover

Scriptya

The first lines of the script carry the metadata that Scriptya reads (# MENU, # DESCRIPTION, # CONFIRM, # TERMINAL, # SUDO, # ICON), so it can be listed there as it is. # ICON points to ../assets/icon5.png; the same image travels inside the script.

Language and roadmap

Both the program and this README are available in English and Spanish. The program picks the language from LANGUAGE, LC_ALL, LC_MESSAGES or LANG (in that order; anything that is not Spanish gives English), unless you saved one with L or set MINTAPP_LANG.

Done, and ideas without a committed date:

Tests

The program removes packages, so its tests are part of the product. They do three things:

bash tests/run_all.sh          # every suite
bash tests/run_all.sh --list   # the suites and what each one checks
bash tests/run_all.sh clean    # only the suites you name
bash tests/lint.sh             # ShellCheck 0.11.0, no findings allowed

The suites (over 7,700 checks) cover the texts in both languages, the catalogs of each desktop, the configuration, install and uninstall (including the embedded icon, compared pixel by pixel with the one in assets/), the package-manager layer, Flatpak and Snap, the menus and removal flows end to end, the search, the cleaning and the windows. The pm suite also runs the real rpm, dnf, pacman and zypper against fake roots when they are installed, and the gui suite drives the real zenity when zenity, Xvfb, openbox and xdotool are installed (with xterm as well, it also checks that the launcher hands the program over to a real terminal). A skipped check always says why.

Contributing

Contributions are welcome. Before opening an issue or a pull request, take a look at CONTRIBUTING.md and CODE_OF_CONDUCT.md. To report a security vulnerability, follow the process in SECURITY.md instead of opening a public issue.

Acknowledgements

The catalog of the deep cleanup follows the cleaners of BleachBit (GPL-3.0-or-later), adapted; each entry in the script names the ones it follows.

License

MintApp Remover is free software distributed under the terms of the GNU General Public License version 3 (GPLv3). See LICENSE.txt for the full text.

Copyright (C) 2026 Filonux


Made by Filonux