to-trash 🚮

to-trash (tt for short) is a fast, small, and hopefully FreeDesktop-compliant file trasher for Linux.

Compliance

tt aims to have compliance with the FreeDesktop.org Trash specification.

Checked items below are what tt considers to be implemented, unchecked is anything that has no or partial implementation.

Some of those are my interpretation of the spec. and not necessarily verbatim to the specification text.

• Considers that the "home trash" is located at $XDG_DATA_HOME/Trash.
  • If XDG_DATA_HOME is not defined, falls back to ~/.local/share/Trash.
• Files that the user trashes from the same mount point as home are stored in the home trash.
• Trashed files are sent to $trash/files.
• An info file is created for every file being trashed.
  • Contains a Path key with the absolute pathname of the original location of the file/directory
  • Contains a DeletionDate key with the date and time when the file/directory was trashed in the YYYY-MM-DDThh:mm:ss format and in the user's local timezone.
• Create or update the $trash/directorysizes file, which is a cache of the sizes of the directories that were trashed into this trash directory.
  • Each entry contains the name and size of the trashed directory, as well as the modification time of the corresponding trashinfo file
  • The size is calculated as the disk space used by the directory and its contents in bytes.
  • The directory name in the directorysizes must be percent-encoded.
• If a $topdir/.Trash does not exist or has not passed the checks:
  • If a $topdir/.Trash-$uid directory does not exist, the implementation must immediately create it, without any warnings or delays for the user.

Feel free to open an issue if you feel like tt is lacking any important features.