RESTORING¶

-z, --restore FILE(s)

To restore items, specify the path to them in the <WASTE>/files directory (wildcards ok).

When restoring an item, if a file or directory with the same name already exists at the destination, the item being restored will have a time/date string (formatted as "_%H%M%S-%y%m%d") appended to it (e.g. 'foo_164353-210508').

-s, --select

select files from list to restore

Displays a list of items in your waste directories. You can use the left/right cursor keys to switch between waste directories. Use the space bar to select the items you wish to restore, then press enter to restore all selected items.

-u, --undo-last

undo last move

Restores files that were last rmw'ed

-m, --most-recent-list

list most recently rmw'ed files

DESKTOP INTEGRATION¶

Items will be moved to a waste basket in the same manner as when using the "move to trash" option from your desktop GUI. They will be separated from your desktop trash by default; or if you wish for them to share the same "trash" directory, uncomment the line (in your config file):

(Note that this does not apply to MacOS; while rmw is yet unable to integrate with the desktop trash directory, you'll still be able to use the default Waste directory.)

then comment out the line

You can reverse which directories are enabled at any time if you ever change your mind. If both directories are on the same filesystem, rmw will use the directory listed first in your config file.

It can be beneficial to have them both uncommented. If your desktop trash directory (~/.local/share/Trash) is listed after the rmw default (~/.local/share/Waste) and uncommented, rmw will place newly rmw'ed items into the default, and it will purge expired files from both.

When rmw'ing an item, if a file or directory with the same name already exists in the waste (or trash) directory, it will not be overwritten; instead, the current file being rmw'ed will have a time/date string (formatted as "_%H%M%S-%y%m%d") appended to it (e.g. 'foo_164353-210508').

REMOVABLE MEDIA¶

The first time rmw is run, it will create a configuration file. Waste directories will be created automatically (Except for when the ',removable' option is used; see below) e.g., if '$HOME/.local/share/Waste' is uncommented in the config file, these two directories will be created:

If a WASTE directory is on removable media, you may append ',removable'. In that case, rmw will not try to create it; it must be initially created manually. When rmw runs, it will check to see if the directory exists (which means the removable media containing the directory is currently mounted). If rmw can't find the directory, it is assumed the media containing the directory isn't mounted and that directory will not be used for the current run of rmw.

With the media mounted, once you manually create the waste directory for that device (e.g. "/mnt/flash/.Trash-$UID") and run rmw, it will automatically create the two required child directories "files" and "info".

RESTORING¶

rmw -z ~/.local/share/Waste/files/foo
rmw -z ~/.local/share/Waste/files/bars*

CONFIGURATION¶

WASTE=/mnt/flash/.Trash-$UID, removable

When using the removable attribute, you must also manually create the directory

expire_age = 45

rmw will permanently delete files that have been in the waste (or trash) for more than 45 days.