TRASH-RESTORE(1)

💖 TRASH-RESTORE(1) 💖

okay bestie, welcome to trash-restore(1) — a manual page from the General Commands Manual, and honestly? it's giving "undo button for your whole life." 🫶

---

✨ NAME ✨

trash-restore — the restore half of the command line trash utility. no cap.

---

🌸 SYNOPSIS 🌸

trash-restore [OPTION] ...  [PATH]

---

🦋 DESCRIPTION 🦋

so basically, this is your glow-up moment: use it to restore a trashed file or directory back to the original path it came from. it puts things back where they belong, like a true friend. 💅

this command is part of the trash-cli package, which is a command line interface trashcan utility that is compliant with the FreeDesktop.org Trash Specification. and the way it does that? it remembers</紫色>... okay no, let me say it properly: it remembers the name, the original path, the deletion date, and the permissions of every single trashed file. iconic behaviour, honestly.

---

🎀 PATH 🎀

the destination file path you wanna restore from the trash.

if you omit it? no worries bestie, it just switches to an interactive selection interface instead. so you get to pick from a lil menu. cute.

---

✨ OPTIONS ✨

• --overwrite — overwrite existing files with the files coming out of the trash. like, yes, we're bulldozing whatever's already sitting there. 🚜
• --sort {date,path,none} — sort the list of restore candidates by the given field. default is date. choices are date, path, or none. 🌈
• --trash-dir=TRASHDIR — restore from TRASHDIR. use this for files that were trashed using a custom TRASHDIR. iykyk. 💜
• -h, --help — show the help message and exit. your lil safety net. 🫶
• --version — show the program's version number and exit. 👑

---

🔥 EXAMPLES 🔥

here's the whole vibe, in one go:

$ trash-restore
0 2007-08-30 12:36:00 /home/andrea/foo
1 2007-08-30 12:39:41 /home/andrea/bar
2 2007-08-30 12:39:41 /home/andrea/bar2
3 2007-08-30 12:39:41 /home/andrea/foo2
4 2007-08-30 12:39:41 /home/andrea/foo
What file to restore [0..4]: 4
$ ls foo
foo

see? you type 4, and foo is BACK. main character energy. 🌟

---

💀 BUGS 💀

found a bug? please, report bugs to https://github.com/andreafrancia/trash-cli/issues — do NOT just suffer in silence, bestie. 😭

---

🍓 IF YOU WANT SAY THANKS 🍓

(this heading is literally what it's called, i'm not changing it, it's too iconic)

tweet at @andreafrancia or use #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

---

🌈 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>. and the first version of the manual pages was written by Steve Stalcup <vorian@ubuntu.com> and was modified by Massimo Cavalleri <submax@tiscalinet.it>. absolute legends, all of them. 👑

---

🧚 SEE ALSO 🧚

• trash-put(1)
• trash-list(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.

---

and that's the whole page, bestie 💖 this was trash-restore(1) from the General Commands Manual — go forth and un-delete things. slay, restore, repeat. 🎀✨🦋