Documentation

gtrash – command-line trash manager

gtrash is a command-line trash manager that implements the FreeDesktop.org Trash specification. It moves files into the system trash rather than permanently deleting them, allowing users to recover discarded files through the terminal or a compatible graphical file manager.

The application combines conventional subcommands with an interactive terminal interface. The restoration screen allows files to be searched, selected and recovered individually or as a group. It also supports restoring files that were removed together during the same operation.

gtrash provides more than basic deletion and restoration. Its commands can report the size of the trash, search for discarded items and remove selected files permanently. Confirmation prompts help reduce the risk of accidentally emptying important data.

The application also supports macOS, although its implementation does not use the native macOS system trash.

This is free and open source software.

Key Features

  • Move files and directories to the system trash using put.
  • Trash directories recursively without requiring -r by default.
  • Configure rm-style behaviour when preferred.
  • List trashed items using find.
  • Search discarded items using regular-expression queries.
  • Display the number and total size of items in the trash.
  • Restore selected items through an interactive terminal interface.
  • Select multiple files for restoration using keyboard controls.
  • Search incrementally within the restoration interface.
  • Restore groups of files deleted by a single operation.
  • Use directory-size caching for size-based filtering.
  • Support integration with fzf and other command-line tools.
  • Provide confirmation before permanently deleting selected items.
  • Support programmable output and filtering for scripted workflows.
  • Cross-platform support – runs on Linux and macOS.

Website: github.com/umlx5h/gtrash
Support:
Developer: umlx5h
License: MIT License

gtrash in action

gtrash is written in Go. Learn Go with our recommended free books and free tutorials.

Alternatives to rm


Explore Linux

Best Free and Open Source Software - A huge collection of recommended free and open source software covering every major category.
In-depth Linux Software Reviews - Detailed assessments of Linux software covering features, usability and overall quality.

The Big List of Active Linux Distros - An extensive collection of actively developed Linux distributions.
Open Source Alternatives - Alternatives to software and services from Google, Microsoft, Apple, Adobe, IBM, Autodesk, Oracle and others.
Essential Linux System Tools - Indispensable utilities for monitoring, maintaining and managing Linux systems.
Linux Productivity Tools - Useful utilities for improving productivity and streamlining everyday tasks.
Alternatives to Popular CLI Tools - Modern alternatives to familiar command-line utilities supplied with Linux systems.
Awesome Free Linux Game Tools - Tools, utilities and companion software that improve gaming on Linux.
Machine Learning on Linux - Machine learning and deep learning software, self-hosted applications and practical tools.
Saving Money with Linux - Practical ways to reduce electricity consumption and lower computing costs with Linux.
Linux Candy - Fun, entertaining and sometimes delightfully quirky software from the lighter side of Linux.
Subscribe

Please read our Comment Policy before commenting.

Notify of
guest
0 Comments
Oldest
Newest Most Voted