trash-cli

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [],
  "categories": [],
  "caveats": null,
  "conflicts_with": [
    "macos-trash",
    "osx-trash",
    "trash"
  ],
  "dependencies": [
    "python@3.14"
  ],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Command-line interface to the freedesktop.org trashcan",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:41:19+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "trash-cli",
  "github_default_branch": "master",
  "github_last_commit_at": "2026-02-03T21:02:00Z",
  "github_readme_excerpt": "trash-cli - Command Line Interface to FreeDesktop.org Trash.\n============================================================\n\n|Downloads|\n\n|Donate|_\n\n`\u7b80\u4f53\u4e2d\u6587`_\n\ntrash-cli trashes files recording the original path, deletion date, and \npermissions. It uses the same trashcan used by KDE, GNOME, and XFCE, but you \ncan invoke it from the command line (and scripts).\n\nIt provides these commands::\n\n    trash-put           trash files and directories. \n    trash-empty         empty the trashcan(s).\n    trash-list          list trashed files.\n    trash-restore       restore a trashed file.\n    trash-rm            remove individual files from the trashcan.\n\nUsage\n-----\n\nTrash a file::\n\n    $ trash-put foo\n\nList trashed files::\n\n    $ trash-list\n    2008-06-01 10:30:48 /home/andrea/bar\n    2008-06-02 21:50:41 /home/andrea/bar\n    2008-06-23 21:50:49 /home/andrea/foo\n\nSearch for a file in the trashcan::\n\n    $ trash-list | grep foo\n    2007-08-30 12:36:00 /home/andrea/foo\n    2007-08-30 12:39:41 /home/andrea/foo\n\nRestore a trashed file::\n    \n    $ trash-restore\n    0 2007-08-30 12:36:00 /home/andrea/foo\n    1 2007-08-30 12:39:41 /home/andrea/bar\n    2 2007-08-30 12:39:41 /home/andrea/bar2\n    3 2007-08-30 12:39:41 /home/andrea/foo2\n    4 2007-08-30 12:39:41 /home/andrea/foo\n    What file to restore [0..4]: 4\n    $ ls foo\n    foo\n    \nRestore a trashed file while overwriting existing files::\n    \n    $ echo \"original\"\u003efoo\n    $ ls\n    foo\n    $ trash foo\n    $ echo \"new\"\u003efoo\n    $ trash-restore --overwrite\n    0 2022-11-01 22:15:00 /home/andrea/foo\n    What file to restore [0..0]: 0\n    $ cat foo\n    original\n\nRestore multiple trashed files separated by \u0027,\u0027, also support range::\n\n    $ trash-restore\n    0 2007-08-30 12:36:00 /home/andrea/foo\n    1 2007-08-30 12:39:41 /home/andrea/bar\n    2 2007-08-30 12:39:41 /home/andrea/bar2\n    3 2007-08-30 12:39:41 /home/andrea/foo2\n    What file to restore [0..3]: 0-2, 3\n    $ ls foo bar bar2 foo2\n    foo bar bar2 foo2\n\nRemove all files from the",
  "github_repo": "andreafrancia/trash-cli",
  "github_stars": 4411,
  "github_topics": [
    "linux",
    "python",
    "trashcan"
  ],
  "homepage": "https://github.com/andreafrancia/trash-cli",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 1543,
  "installs_365d": 18194,
  "installs_90d": 4639,
  "keg_only": 1,
  "keg_only_reason": ":shadowed_by_macos",
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "GPL-2.0-or-later",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "trash-cli",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 1099,
  "rank_365d": 1113,
  "rank_90d": 1131,
  "raw_hash": "2420d4c2ec9be55f",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/t/trash-cli.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "0.24.5.26",
  "versioned_formulae": [],
  "why_use_this": null
}