unburden-home-dir(1)

home-dir - unburdens home directories from caches and trashes

Section 1 unburden-home-dir bookworm source

Description

UNBURDEN-HOME-DIR

NAME

unburden-home-dir - unburdens home directories from caches and trashes

SYNOPSIS

Image grohtml-55875-1.png

DESCRIPTION

unburden-home-dir unburdens the home directory from files and directory which cause high I/O or disk usage but are neither important if they are lost, e.g. caches or trash directory.

When being run it moves the files and directories given in the configuration file to a location outside the home directory, e.g. /tmp or /scratch, and puts appropriate symbolic links in the home directory instead.

OPTIONS

-b

use the given string as basename instead of "unburden-home-dir".

-c

read an additional configuration file.

-C

read only the given configuration file

-f

just unburden those directory matched by the given filter (a perl regular expression) - it matches the already unburdened directories if used together with -u.

-F

Do not check for files in use with lsof before (re)moving files.

-l

read an additional list file

-L

read only the given list file

-n

dry run (show what would be done)

-u

undo (reverse the functionality and put stuff back into the home directory)

-h, --help

show this help

--version

show the program’s version

EXAMPLES

Example configuration files can be found at /usr/share/doc/unburden-home-dir/examples/ on Debian-based systems and in the etc/ directory of the source tar ball.

FILES

/etc/unburden-home-dir, /etc/unburden-home-dir.list, ˜/.unburden-home-dir, ˜/.unburden-home-dir.list, ˜/.config/unburden-home-dir/config, ˜/.config/unburden-home-dir/list, /etc/default/unburden-home-dir, /etc/X11/Xsession.d/95unburden-home-dir

Read the documentation at either /usr/share/doc/unburden-home-dir/html/ on debianoid installations, at https://unburden-home-dir.readthedocs.io/ online, or in the docs/ directory in the source tar ball for an explanation of these files.

SEE ALSO

corekeeper https://packages.debian.org/corekeeper, autotrash(1), agedu(1), bleachbit(1), mundus https://sebikul.github.io/mundus/, computer-janitor(1), rmlint(1).

Of, course, du(1) can help you to find potential files or directories to handle by unburden-home-dir, but there are quite some du(1)-like tools out there which are way more comfortable, e.g. ncdu(1) (text-mode), baobab(1) (GNOME), filelight(1) (KDE), xdiskusage(1) (X tool calling du(1) itself), or xdu(1) (X tool reading du(1) output from STDIN).

AUTHOR

Unburden Home Dir is written and maintained by Axel Beckert abe@deuxchevaux.org.

LICENSE

Unburden Home Dir is available under the terms of the GNU General Public License (GPL) version 2 or any later version at your option.

See Also