trashsh - Console trash management

trashsh is a POSIX shell implementation of the Freedesktop.org trashcan specification. It lets you run trash <file> to move a file to the trash instead of just rm <file>, which permanently deletes it immediately. Later, the file can be recovered with trash -u <file> or permanently erased with trash -e <file>. More details are in the Usage section. This is based off of bashtrash, but with a few more features and a little bit cleaned up and tweaked to be fully POSIX-compliant, rather than relying on bashisms.

Requirements

trashsh requires the following utilities in addition to the standard tools (mv, rm, etc.):

• awk
• basename
• date
• df
• du
• dirname
• find
• mktemp
• perl (only used to URL encode filenames)
• readlink
• sed
• stty
• tput

Optionally, if you install my other tools ask and arg, you'll get slightly nicer behavior, although trash should work perfectly fine without them. (ask)[https://bitbucket.org/spilt/ask] will get you slightly cleaner confirmation prompts, and (arg)[https://bitbucket.org/spilt/arg] will get more robust command line flag parsing (without arg, you must use trash -f -v -E instead of trash -fvE).

Usage

Basic usage: trash [OPTIONS]... FILES...

Options:

• -h, --help Show the program usage and exit
• -V, --version Show program's version number and exit
• -v, --verbose Explain what is being done
• -i, --interactive Prompt before moving every file
• -f, --force Ignore non-existent files, never prompt
• -r, -R, --recursive Ignored (for compatability with rm)
• -u, --untrash Restore file(s) from the trash
• -e, --empty Choose files to empty from the trash
• -E, --empty-all Empty all the files in the trash folder(s) (default: ~)
• -l, --list List files in trash folder(s) (default: ~)
• -- Any arguments after -- will be treated as filenames

See man trash for full documentation.

License

Copyright (c) 2020, Bruce Hill bruce@bruce-hill.com Copyright (c) 2009-2011, Robert Rothenberg robrwo@gmail.com

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.