andreafrancia/trash-cli

これは何？

主な機能

• 01KDE、GNOME、XFCEと共通のfreedesktop.orgのゴミ箱へファイルを移動します。
• 02ゴミ箱に入れた項目ごとに、元のパス、削除日時、権限を記録します。
• 03対話的に項目を復元でき、上書きや範囲指定にも対応します。
• 04ゴミ箱全体を空にするか、N日より古い項目だけを削除できます。
• 05bash、zsh、tcshのシェル補完を提供します。

ユースケース

• 日常のターミナル作業でrmの代わりに使い、誤って削除したファイルを復元できるようにする。
• cronで毎日実行する古いゴミ箱内ファイルのクリーンアップを設定する。
• スクリプトやシェルから、ゴミ箱に入れたファイルを検索して復元する。

クイックスタート

1. 1

   pipxでtrash-cliをインストール（推奨）

   pipx install trash-cli
2. 2

   またはpipでインストール

   pip install trash-cli
3. 3

   ファイルをゴミ箱に移動

   trash-put foo
4. 4

   ゴミ箱内のファイルを一覧表示

   trash-list

使う前に知っておきたいこと

• !Btrfsボリュームには対応していません。
• !復元と一覧表示の動作はfreedesktop.orgのゴミ箱レイアウトに依存するため、そのゴミ箱が使われている環境でのみ動作します。

トピック

よくある質問

trash-cli とは？

ファイルをKDE、GNOME、XFCEと共通のfreedesktop.orgのゴミ箱へ移動するコマンドラインツール。 trash-cliを使うと、ファイルやディレクトリを完全に削除せず、ターミナルからfreedesktop.orgのゴミ箱へ移動できます。ゴミ箱に入れた項目には元のパス、削除日時、権限が記録されるため、後から探して復元できます。

trash-cli は無料で使えますか？ライセンスは？

trash-cli は GPL-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

trash-cli は今もメンテナンスされていますか？

活発にメンテナンス中。trash-cli の最終コミットは 2026年10月16日 です。

trash-cli は何に使えますか？

日常のターミナル作業でrmの代わりに使い、誤って削除したファイルを復元できるようにする。 cronで毎日実行する古いゴミ箱内ファイルのクリーンアップを設定する。 スクリプトやシェルから、ゴミ箱に入れたファイルを検索して復元する。

trash-cli のインストール方法は？

pipxでtrash-cliをインストール（推奨）: pipx install trash-cli またはpipでインストール: pip install trash-cli ファイルをゴミ箱に移動: trash-put foo ゴミ箱内のファイルを一覧表示: trash-list

trash-cli はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/andreafrancia/trash-cli