Repolode
Enviar
andreafrancia

andreafrancia/trash-cli

Ferramenta de linha de comando que move arquivos para a lixeira do freedesktop.org, usada também pelo KDE, GNOME e XFCE.

Ver no GitHub
Estrelas
4,612
Forks
213
Issues abertas
78
Último commit
há 3 dias

O que é?

O trash-cli permite enviar arquivos e diretórios para a lixeira do freedesktop.org pelo terminal, em vez de excluí-los permanentemente. Cada item descartado mantém o caminho original, a data de exclusão e as permissões, para que possa ser encontrado e restaurado depois.

O pacote instala cinco comandos: trash-put, para enviar arquivos à lixeira; trash-list, para listá-los; trash-restore, para restaurar um item (inclusive sobrescrevendo arquivos existentes e restaurando vários de uma só vez); trash-empty, para esvaziar a lixeira ou remover apenas itens com mais de um número definido de dias; e trash-rm, para remover arquivos individuais que correspondam a um padrão. Como usa a mesma lixeira dos gerenciadores de arquivos da área de trabalho, os itens enviados para lá também aparecem nesses aplicativos.

O projeto é escrito em Python, pode ser instalado via pipx, pip ou gerenciadores de pacotes do sistema, como apt, pacman, dnf e Homebrew, e oferece complementos de shell para bash, zsh e tcsh. Não oferece suporte a volumes Btrfs.

Recursos principais

  • 01Move arquivos para a lixeira do freedesktop.org, compartilhada com KDE, GNOME e XFCE.
  • 02Registra o caminho original, a data de exclusão e as permissões de cada item descartado.
  • 03Restaura itens de forma interativa, com opções para sobrescrever arquivos e selecionar intervalos.
  • 04Esvazia a lixeira por completo ou remove apenas itens com mais de N dias.
  • 05Oferece complementos de shell para bash, zsh e tcsh.

Casos de uso

  • Substituir rm nas tarefas diárias pelo terminal e manter recuperáveis as exclusões acidentais.
  • Agendar a limpeza diária de arquivos antigos da lixeira com cron.
  • Pesquisar e restaurar arquivos descartados usando scripts ou o shell.

Início rápido

  1. 1

    Instale o trash-cli com pipx (recomendado)

    pipx install trash-cli
  2. 2

    Como alternativa, instale com pip

    pip install trash-cli
  3. 3

    Mover um arquivo para a lixeira

    trash-put foo
  4. 4

    Listar arquivos na lixeira

    trash-list

Antes de usar

  • Não oferece suporte a volumes Btrfs.
  • A restauração e a listagem dependem do layout de lixeira do freedesktop.org; por isso, funcionam apenas onde essa lixeira é usada.

Tópicos

#linux#trashcan#command-line#freedesktop#python#file-management

Perguntas frequentes

O que é trash-cli?
Ferramenta de linha de comando que move arquivos para a lixeira do freedesktop.org, usada também pelo KDE, GNOME e XFCE. O trash-cli permite enviar arquivos e diretórios para a lixeira do freedesktop.org pelo terminal, em vez de excluí-los permanentemente. Cada item descartado mantém o caminho original, a data de exclusão e as permissões, para que possa ser encontrado e restaurado depois.
trash-cli é gratuito? Qual é a licença?
trash-cli é open source sob a licença GPL-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
trash-cli ainda é mantido?
Manutenção ativa. O último commit de trash-cli foi em 16 de out. de 2026.
Para que posso usar trash-cli?
Substituir rm nas tarefas diárias pelo terminal e manter recuperáveis as exclusões acidentais. Agendar a limpeza diária de arquivos antigos da lixeira com cron. Pesquisar e restaurar arquivos descartados usando scripts ou o shell.
Como instalar trash-cli?
Instale o trash-cli com pipx (recomendado): pipx install trash-cli Como alternativa, instale com pip: pip install trash-cli Mover um arquivo para a lixeira: trash-put foo Listar arquivos na lixeira: trash-list
Onde consigo trash-cli?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/andreafrancia/trash-cli

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados