trash-rm

trash-rm is a cli tool that creates its own trash directory and moves files and directories there instead of deleting them permanently.

Inspiration

This project is inspired by trash-cli, created by Andrea Francia.

The goal of trash-rm is not to replace the original project. Instead, it was created as a learning exercise to study the core idea behind the tool and build a new implementation from scratch based on that understanding.

Installation

# Clone
git clone https://github.com/wiirios/trash-rm.git
cd trash-rm

# Install
sudo make install

# Uninstall
sudo make uninstall

Usage

Below are all the available commands.

trash-rm move           trash the file.
trash-rm list           lists the files in the trash.
trash-rm match-move     move a file with a pattern.
trash-rm clean          empty the trash.
trash-rm remove         remove a file from the trash.
trash-rm recover        recovers a file from the trash.

Examples

Move a single file to the trash:

trash-rm move notes.txt

Move all files ending with .txt

trash-rm match-move *.txt

Removes a specific file from the trash.

trash-rm remove min.c

Recover a file from the trash.

trash-rm recover bump.mp4

TODO

Planned improvements and missing features:

• Make it cross-platform with Windows.
• Improve error handling.
• Add better logging.
• Replace repetitive code with shared utility functions
• Create a function to recover all files from the Trash bin.

Project status

This project is still under active development and is not recommended for production use. If you choose to try it, please restrict your tests to the test folder and use it with caution.

Contributing

Contributions are welcome. If you find a bug, have an improvement idea, or want to help with documentation and features, feel free to open an issue or submit a pull request.

MIT License

This project is licensed under MIT license, read more at docs.github