Trash-cli – A Trashcan Tool to Manage ‘Trash’ from Linux Command Line

Trash-cli is a command line interface that trashes files and records the original absolute path, deletion date, and associated permissions. It uses the same trashcan used by popular Linux desktop environments such as KDE, GNOME, and XFCE which can be invoked from the command line (and via scripts).

Trash-cli provides these commands:

$ trash-put           #trash files and directories.
$ trash-empty         #empty the trashcan(s).
$ trash-list          #list trashed files.
$ trash-restore       #restore a trashed file.
$ trash-rm            #remove individual files from the trashcan.

In this article, we will show you how to install and use trash-cli to find the original path, deletion date, and permissions of deleted files in Linux.

How to Install Trash-cli in Linux

The straightforward way of installing trash-cli is by using easy_install tool as follows:

$ sudo apt-get install python-setuptools		#Debian/Ubuntu systems
$ sudo yum install python-setuptools			#RHEL/CentOS systems
$ sudo easy_install trash-cli	

Else, install Trash-cli from source as shown.

$ git clone https://github.com/andreafrancia/trash-cli.git
$ cd trash-cli
$ sudo python setup.py install

How to Use Trash-cli in Linux

To trash a specific file, run.

$ trash-put file1

List all trashed files.

$ trash-list

2017-05-05 10:30:48 /home/tecmint/file1
2017-05-10 13:40:41 /home/tecmint/file2
2017-05-12 22:30:49 /home/tecmint/file3
2017-05-12 22:50:48 /home/tecmint/test

Search for a file in the trashcan.

$ trash-list | grep file

2017-05-05 10:30:48 /home/tecmint/file1
2017-05-10 13:40:41 /home/tecmint/file2
2017-05-12 22:30:49 /home/tecmint/file3

Restore a trashed file.

$ trash-restore

0 2017-05-05 10:30:48 /home/tecmint/file1
1 2017-05-10 13:40:41 /home/tecmint/file2
2 2017-05-12 22:30:49 /home/tecmint/file3
3 2017-05-12 22:50:48 /home/tecmint/test

Remove all files from the trashcan.

$ trash-empty

Remove only the files that have been deleted more than <days> ago:

$ trash-empty <days>

Here is a demonstration of this command:

$ date
Mon May 15 20:26:52 EAT 2017
$ trash-list
2017-05-12 13:51:12 /home/tecmint/new.txt
2017-05-11 10:41:30 /home/tecmint/old.txt
2017-04-05 20:43:54 /home/tecmint/oldest.txt
$ trash-empty  7
$ trash-list
2017-05-12 13:51:12 /home/tecmint/new.txt
2017-05-11 10:41:30 /home/tecmint/old.txt
$ trash-empty 1
$ trash-list
2017-05-12 13:51:12 /home/tecmint/new.txt

Remove only files matching a pattern.

Do not forget to use quotes in order to protect the pattern from shell expansion:

$ trash-rm  \*.txt

For more information, check out Trash-cli Github repository: https://github.com/andreafrancia/trash-cli

That’s all! Do you know of any similar CLI tools for Linux? Share some info about them with us via the comment form below.

If this article helped, with someone on your team.

TecMint Weekly Newsletter
Get the Learn Linux 7 Days Crash Course free when you join 34,000+ Linux professionals reading every Thursday.
Check your email for a magic link to get started.
Something went wrong. Please try again.
TecMint has been free for 14 years. Help keep it that way.
Google AI Overviews and tools like ChatGPT have cut into search traffic for independent tech sites like TecMint. Running this site costs over $2,000 every month for hosting, infrastructure, and paying authors to keep the content accurate and tested.

If this article helped you solve a problem, consider buying a coffee. It helps keep TecMint free, supports the authors, and keeps the project going.
☕ Buy Me a Coffee
Aaron Kili
Aaron Kili is a Linux and F.O.S.S enthusiast, an upcoming Linux SysAdmin, web developer, and currently a content creator for TecMint who loves working with computers and strongly believes in sharing knowledge.

Each tutorial at TecMint is created by a team of experienced Linux system administrators so that it meets our high-quality standards.

6 Comments

Leave a Reply
      • Dear Aaron, thank you for the fast message but I have to disappoint you:

        DEPRECATION: Uninstalling a distutils installed project (trash-cli) has been deprecated and will be removed in a future version. This is due to the fact that uninstalling a distutils project will only partially uninstall the project.
        Uninstalling trash-cli-0.17.1.14:
        /usr/lib/python2.7/site-packages/trash_cli-0.17.1.14-py2.7.egg-info
        Proceed (y/n)? y
        Successfully uninstalled trash-cli-0.17.1.14

        but if I retry to use the trash command it still working… do you have any ideas?

        Reply
        • @Duc

          Ensure that you are using the latest version of PIP. If it still fails, try the next option, which is to run the following command, which removes all dependencies of trash-cli:

          $ sudo easy_install -m trash-cli
          

          Then remove the egg file for the trash-cli package:

          $ sudo rm -rf /usr/lib/python2.7/site-packages/trash_cli-0.17.1.14-py2.7.egg
          

          I hope this will help you.

          Reply

Got Something to Say? Join the Discussion...

Thank you for taking the time to share your thoughts with us. We appreciate your decision to leave a comment and value your contribution to the discussion. It's important to note that we moderate all comments in accordance with our comment policy to ensure a respectful and constructive conversation.

Rest assured that your email address will remain private and will not be published or shared with anyone. We prioritize the privacy and security of our users.

Free Course
Get a free Linux course before you go.
Subscribe to TecMint Weekly and get the Learn Linux 7 Days Crash Course free. Read by 34,000+ Linux professionals every Thursday.
Something went wrong. Please try again.
Check your email for a magic link to get started.