trm - Temporary rm

trm is a temporary rm command that moves files to a temporary directory instead of deleting them. This is useful when you want to delete files but are not sure if you might need them later. Note that this program is not a replacement for rm and should not be used as such. A conscious decision has been taken to not follow the XDG Trash specification.

Installation

The easiest way to install trm is to use cargo:

cargo install trm

Usage

trm - Temporary rm, a utility to reversibly remove your files

Usage: trm [OPTIONS] [FILES]... [COMMAND]

Commands:
  history  Shows history of all operations performed. For details on format for `before`, use --help
  purge    Purge from trash and also corresponding logs. If --before not specified then takes 30 days as default
  help     Print this message or the help of the given subcommand(s)

Arguments:
  [FILES]...  Files to delete

Options:
  -v, --verbose    Display full file paths or not
      --debug      Debug output
  -u, --undo       Recover files from the trash
  -a, --all        All operation. If combined with -l, will list all files in trash If combined with --undo, will recover all files from trash
  -l, --list       Display all files trashed under given directories. Takes current directory as default if no other directory given
  -d, --dir <DIR>  Directory where to move [default: /var/tmp/trm_files]
  -h, --help       Print help
  -V, --version    Print version

Basic usage:

$ trm file1 dir1/

Undo:

$ trm -u file1 dir1/

List all trashed files:

$ trm -l

To recover all files trashed in current directory:

$ trm -lu

--all command can also be used to list all trashed files:

$ trm -la

and same for undo to recover all files:

$ trm -ua

History of logs

Shows history of all operations performed. For details on format for `before`, use --help

Usage: trm history [OPTIONS]

Options:
  -a, --all              Show all the history
  -b, --before <BEFORE>  Show all changes before current time - given time
      --path <PATH>      Directory to see history of. If no path specified, will show history in cwd [default: ]
  -h, --help             Print help (see more with '--help')

By default, it will show all history of the current working directory:

$ trm history

But duration can be specified:

$ trm history --before 1d

Or for a specific directory:

$ trm history --path /path/to/dir

or all logs:

$ trm history --all

Purge

Purge from trash and also corresponding logs. No files are deleted if --before is not provided

Usage: trm purge [OPTIONS]

Options:
  -b, --before <BEFORE>  Remove items before current time - given time. Follows same semantics as in history
  -q, --quiet            Confirm before purging
  -a, --all              Purge all files in trash
  -h, --help             Print help

Duration must always be specified, which follow same semantics as in history:

$ trm purge --before 1d

Or can purge all the files in trash:

$ trm purge --all

By default, it will ask for confirmation before purging, but can be disabled:

$ trm purge --before 1d --quiet

Notes

• If you do have $XDG_DATA_HOME set, the default directory will be $XDG_DATA_HOME/trm_files. Otherwise, it will be /var/tmp/trm_files.
• There is no way to recover files once they are purged, so be careful with this command.