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.

Two small things before you go

If something didn’t work on your setup, leave a comment and tell me which distro and version you’re on. I read every one, and most of these articles got better because a reader pointed out what was missing.

And if it did work, share it. TecMint has stayed free for 14 years because people pass these articles around, and that traffic is what pays for writing the next one.

Leave a comment
Get two free Linux courses

Learn the Linux basics with two free courses and join 34,000+ readers getting practical TecMint tutorials and selected Pro TecMint articles every week.

Pro TecMint
Get lifetime access for $99

If you want to go beyond the free tutorials, Pro gives you 18 courses, 5 ebooks, and every future course I add. One payment, lifetime access, no renewals.

Aaron Kili
Aaron Kili
Contributor
About the author

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.

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.