Skip to main content

A simple utility to clean your mac of old stuff

Project description


A simple command line tool to clean old stuff from your mac.



$ cleanmymac -h
usage: cleanmymac [-h] [-u] [-d] [-q] [-l] [-s] [-c CONFIG] [-t TARGETS_PATH]
                  [TARGETS [TARGETS ...]]

cleanmymac v0.1.8, a simple utility designed to help clean your mac from
old/unwanted stuff

positional arguments:
  TARGETS               the list of targets to execute. Execute all if not

optional arguments:
  -h, --help            show this help message and exit
  -u, --update          update the target if applicable
  -d, --dry_run         describe the actions to be performed, do not execute
  -q, --quiet           run in quiet mode
  -l, --list            list registered cleanup targets
  -s, --stop_on_error   stop execution when first error is detected
  -c CONFIG, --config CONFIG
                        specify the configuration path
  -t TARGETS_PATH, --targets_path TARGETS_PATH
                        specify extra yaml defined targets path

a typical usage pattern is:

$ cleanmymac


install from pypi:

$ pip install cleanmymac

clone the repository locally and issue

$ python install


the cleanmymac utility accepts a configuration file by specifying the -c option. If not specified the file is assumed to be at the following location ~/.cleanmymac.yaml

the global configuration can be used (for now) to pass specific env vars to shell commands, for example assume that anaconda is not in the main path:

cleanmymac: {
  targets_path: ['.']
anaconda: {
  env: {
    PATH: '~/anaconda/bin',


one can add more cleanup targets either by installing them as python classes registered to the following entry-point: like this (in

    # ....
    '': [
        'my_target_name = my.python.package.MyTargetClass'
    # ...

alternatively for shell based commands simply create yaml files with the following schema:

type: 'cmd'
spec: {
  update_commands: [
    'brew update',
    'brew outdated | brew upgrade'
  clean_commands: [
    'brew cleanup'

or for cleaning up directories (removing all but the latest version):

type: 'dir'
spec: {
    update_message: 'Get the latest MacTex version from',
    entries: [
            dir: '/usr/local/texlive/',
            pattern: '\d+'

note: see the cleanmymac.builtins module for more details

and point cleanmymac to the folder where the yaml files reside with the -t command line option

builtin targets

to see a list of builtin targets run:

$ cleanmymac -l
currently the following are supported:
  • homebrew

  • java jdk

  • mactex

  • anaconda

  • trash


I created this utility in the hope that others may find it useful, as I found it annoying to always remember how and what to clean from my mac. This is work in progress, so use at your own risk!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cleanmymac-0.1.10.tar.gz (15.8 kB view hashes)

Uploaded Source

Built Distribution

cleanmymac-0.1.10-py2-none-any.whl (21.4 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page