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
Version 2.2.0:
L switches it at any moment. This README is available in both languages too.dnf (version 4), pacman and zypper are supported (see Compatibility). The manager is chosen at start; MINTAPP_PM forces one.install puts a command, a menu launcher and the icon in your own folders, with no sudo. The launcher opens the graphical menu when there is no terminal, or a terminal if that was your last choice (T).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.
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).
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.
The same menu in windows (`zenity`). `T` goes back to the terminal.
Option 3, advanced mode, in windows: applications found from the menu launchers, each with its package. Flatpak ones show their ID.
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`.
Option 3 in the terminal: the same list. The last row lists the keys that work on the screen.
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.
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:
apt-get -s purge (a simulation: it changes nothing and needs no administrator rights) and shows it as it is, including any dependent package that apt decides to drag along. You confirm (the default answer is “no”), the plan is checked again, and only then does it ask for your password..desktop files) and asks the package manager who owns each one, so it finds applications the catalog does not know about.NO_COLOR, plain ASCII when the locale is not UTF-8, a plain-text menu when whiptail is not wanted, and windows (zenity) when there is no terminal at all.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:
dnf 5 (Fedora 41 and later) is not supported. The program detects it and stops with a clear message.dnf refuses to calculate a plan without administrator rights, so with it the password is asked before the plan is shown. apt, pacman and zypper calculate it without.rpm has no “purge”: with dnf, configuration files you changed stay as .rpmsave.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.
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.
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
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.
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.
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:
Essential, or priority required or important).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.
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 | ✓ | ✓ |
~/.cache it removes everything, and the archived journal goes./tmp, /var/tmp, /var/log, /var/crash, /var/lib/systemd/coredump and /var/cache/apt.A typical session, step by step:
./script/MintApp_Remover.sh. Read the first screen and press Enter.2. The list shows what is installed. Move with ↑ ↓, mark with Space, or press / to search. Confirm with Enter on OK.Enter removes nothing.dnf, it already did) and run the removal.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):
~/.local/state/mintapp-remover/: one removal-DATE-TIME-….txt record per removal, with what was planned and how to reinstall it ($XDG_STATE_HOME is respected). It is written before the removal starts and replaced when it ends, so an interrupted run still leaves a record.~/.config/mintapp-remover/config ($XDG_CONFIG_HOME is respected), with three keys:| 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 |
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
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.
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:
install and uninstall commands, with menu launcher and icondnf, pacman and zypperT) from the windows; the launcher remembers the choice.debThe program removes packages, so its tests are part of the product. They do three things:
apt, dpkg, sudo and the other managers, so they never touch the real system. They check what this README promises: the plan shown is the one the package manager reports, nothing is removed before you confirm, a flow cut off at any step ends cleanly and leaves nothing behind, and every text exists in both languages and fits the width of the terminal..github/workflows/quality.yml) runs ShellCheck, the Bash syntax check and every suite on each push or pull request that changes script/, tests/, the embedded icon or the workflow itself, and repeats the suites on Debian 12 and 13, Ubuntu 22.04 and 24.04 and on a real bash 4.3. A change that breaks something shows up in its pull request.CONTRIBUTING.md).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.
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.
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.
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