Skip to content

Latest commit

 

History

History
55 lines (33 loc) · 1.36 KB

README.md

File metadata and controls

55 lines (33 loc) · 1.36 KB

DotClean - List and clean old or unused dotfiles/dotdirs

Installation

Steps assume that python (>=3.6) and pip are already installed.

$ pip install dotclean

Install directly from github:

$ pip install git+https://github.com/amstelchen/DotClean#egg=DotClean

When completed, run it with:

$ dotclean [...]

Usage

$ dotclean -h
usage: dotclean [-h] [-f] [-d] [-x days] [-n] [-c days] [-v]

List and clean old or unused dotfiles/dotdirs,

options:
  -h, --help            show this help message and exit
  -f, --files           only apply to files
  -d, --directories     only apply to directories
  -x days, --exclude days
                        exclude files not older than {x} days
  -n, --nocolor         disable colored output
  -c days, --clean days
                        clean files older than {x} days (DANGEROUS!)
  -v, --version         show program's version number and exit

Safety feature

Setting the environment variable DOTCLEAN enables the program to really wipe entire files and directories, even if they are not empty. USE WITH CAUTION!

Examples

Listing directories in ~/.config:

screenshot-1

Set a limit in days on files which are quite old:

screenshot-2

Set env DOTCLEAN=1 to arm the file deleter:

screenshot-3