trash-list(1)

✨ trash-list — bestie edition 💖

okay so you know that trash-list thing? it's a manual page, from the General Commands Manual, and it's literally just about listing your trashed files. no cap, that's the whole vibe. sit down, grab a 🍓, let's go.

---

🌸 NAME 🌸

trash-list — List trashed files.

periodt. that's it. that's the name.

---

🦋 SYNOPSIS 🦋

trash-list [OPTIONS]...

literally just the command, and you can pile options on top of it like sprinkles. 💅

---

💜 DESCRIPTION 💜

List all the contents of the trashcan.

like... all of it. every single thing chillin' in there. it's giving "receipts of your past decisions" energy, and honestly? iconic. 🔥

---

✨ OPTIONS ✨

• -h, --help — Show help message and exit. your girl needs directions? here they are, then she dips. 🫶
• --trash-dir=TRASHDIR — Use TRASHDIR as trash folder. Can be used multiple times. so if you've got several trash folders and you're a multi-trash-folder kind of person (main character energy, we love), just say it more than once. no limit, bestie.
• --version — Show program's version number and exit. the "what era of me are you running" flag. ⭐

---

🌈 EXAMPLES 🌈

List all trashed files or grep output:

$ trash-list
2008-06-23 21:57:26 /home/andrea/src/bluetrash/pippo
2008-06-23 21:50:41 /home/andrea/foobar
2008-06-23 21:50:49 /home/andrea/foobar
2008-06-23 21:53:13 /media/disk/adsfljasldj
$ trash-list | grep foo
2008-06-23 21:50:41 /home/andrea/foobar
2008-06-23 21:50:49 /home/andrea/foobar

see how it just... prints the date and the path? and then the pipe + grep foo is you being a detective about the foobar situation. 🔍 two whole foobar entries in there, and honestly? relatable.

---

💀 BUGS 💀

Please, report bugs to https://github.com/andreafrancia/trash-cli/issues

if something's cursed, do NOT suffer in silence, bestie. go tell the nice people at that URL. they want to know. fr fr. 🙈

---

🎀 IF YOU WANT SAY THANKS 🎀

Tweet (to @andreafrancia or #trash-cli) or donate 1, 2 or 5 euros using paypal: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=93L6PYT4WBN5A

one euro, two euros, five euros — pick your fighter. and if you're broke (same), a tweet costs nothing and hits different. 💖

---

👑 CREDITS 👑

Trash was written by Andrea Francia <andrea@andreafrancia.it>. The original version of trash-empty was contributed by Einar Orn Olason <eoo@hi.is>. The first version of manual pages was written by Steve Stalcup <vorian@ubuntu.com> and was modified by Massimo Cavalleri <submax@tiscalinet.it>.

shoutout to the whole squad who built this. we stan. 🧚

---

🌸 SEE ALSO 🌸

trash-put(1), trash-restore(1), trash-empty(1), trash-rm(1), and the FreeDesktop.org Trash Specification at https://specifications.freedesktop.org/trash-spec/trashspec-1.0.html.

Both are released under the GNU General Public License, version 2 or later.

heads up bestie: trash-list is the "look at it" one — the friends above are the "do something about it" ones. iykyk.

---

okay and the little sign-off at the bottom of the original page is just the manpage saying its own name again — trash-list(1) — so consider this your cute lil' goodnight kiss: this page is trash-list(1), from the General Commands Manual, and it's yours now. go forth and list. 💅✨