hrik2001 / macuninstaller

macuninstaller is a lightweight uninstaller for mac. It makes making uninstallation of app easy and flexible :)

macuninstaller

macuninstaller is a python script that was written to uninstall mac apps. This script finds all the related files and folders and deletes them for you. You can use both the GUI version and CLI version of macuninstaller.

Download

MACUNINSTALLER EXISTS AS BOTH APP AND BINARY FILE, SO GET WHAT PLEASES YOU FROM RELEASES
You can checkout the latest releases and can even download the binary from there
https://github.com/hrik2001/macuninstaller/releases/
And move the binary to this path so that you can directly use it as a command in your terminal :)-
/usr/local/bin/

Or you can download this repository.
git clone https://github.com/hrik2001/macuninstaller

Usage

If you are using the python script then type this-
python cli.py -p /path/to/app
Or this if you are using the binary
macuninstaller -p /path/to/app and it will output the possible files and folders that are related to the app you just specified.
You can also do a custom scan where you have to type the path of the app and the directories in which you want to search for files affiliated with the app.
python cli.py -p /path/to/app -c /path1/ /path2/ /path3/
And for the binary -
macuninstaller -p /path/to/app -c /path1/ /path2/ /path3/
For the GUI version, just run
python macuninstaller.py

UI Help

The CLI version is very user friendly, here is a peek :)

The CLI version lets you choose the files and folders by using up and down arrow keys, if you want to select/deselect files/folders you can do so with space, if you want to quit the program then press "q". After that you will be asked to type your password and with a breeze your app will be uninstalled.
Here is the look of the GUI
NOTE: YOU HAVE TO RUN THE SCRIPT IN SUDO
First you have to choose what kind of scan do you want to have for the app you want to uninstall

For both of the scans you will be greeted with

For custom scan you would be greeted with this window where it would ask you to type folder names, seperated by comma . macuninstaller will search in those folders. Suggested folders already appear in text field

Also you will have a suggestor feature which will suggest if the file/folder should be deleted or not. The confused emoji shows that it is not suggested to delete the file and the smiley face for vice versa

Contribution

hexx112 for making the website which is accessible at macuninstaller

macuninstaller's Issues

Exception throwed when trying to open app

Inability to find files and folders when certain stuff in Info.plist aint available

For this we need to make a try exception block to catch the exception and then do something about it

Exception on initial cli.py script run

I tried to follow the README instructions but I got an exception on initial script run.

My exact steps with Python 2.7.10:

$ git clone https://github.com/hrik2001/macuninstaller.git
Cloning into 'macuninstaller'...
remote: Counting objects: 638, done.
remote: Compressing objects: 100% (317/317), done.
remote: Total 638 (delta 175), reused 463 (delta 154), pack-reused 154
Receiving objects: 100% (638/638), 8.08 MiB | 3.18 MiB/s, done.
Resolving deltas: 100% (232/232), done.

$ cd macuninstaller/

$ python cli.py /Applications/PlayOnMac.app
Traceback (most recent call last):
  File "cli.py", line 1, in <module>
    from function import *
  File ".../macuninstaller/function.py", line 5, in <module>
    import queue
ImportError: No module named queue

I tried to run the same script with Python 3.6.3 and I go the following exception:

$ python3 cli.py /Applications/PlayOnMac.app
  File "cli.py", line 14
    print doc
            ^
SyntaxError: Missing parentheses in call to 'print'. Did you mean print(doc)?

README file refactoring

I think that there are slight improvements need to be made in README file:

1. Running python ./cli.py -p /Applications/QuickTime\ Player.app/
   Lists application paths, but there's no removal option, therefore

macuninstaller is a python script that was written to uninstall mac apps. This script finds all the related files and folders and deletes them for you

Should be changed to something more appropriate - identifying that you can uninstall only through the GUI version (aka macuninstaller.py)

2. Supported Python version Identification should be added to README.
   You get Python version prompt when running with an unsupported version - but it's only after you've downloaded and run the script.

zsh: permission denied: macuninstaller

I've just mv the file from Downloads to /usr/local/bin/ and get this error.
Maybe is this my fault, but also a small update in the how to can avoid this.