awesome-repositories.com
Blog
MCP
awesome-repositories.com

Discover the best open-source repositories with AI-powered search.

ExploreCurated searchesOpen-source alternativesSelf-hosted softwareBlogSitemap
ProjectMCP serverAboutHow we rankPress
LegalPrivacyTerms
© 2026 Bringes Technology SRL·VAT RO45896025·hello@awesome-repositories.com
andreafrancia avatar

andreafrancia/trash-cli

0
View on GitHub↗

Trash Cli

trash-cli is a command-line interface for managing files and directories within the FreeDesktop.org trashcan specification. It provides a utility to move files to a system trash folder instead of permanently deleting them, preventing accidental data loss when working in a terminal.

The tool implements the XDG trash directory layout and metadata standards, ensuring interoperability with other desktop environment tools. It uses metadata sidecar files to track original absolute file paths and deletion timestamps, allowing for precise file recovery.

The project covers file lifecycle management through capabilities for listing deleted items, restoring files to their original locations, and reclaiming disk space. Permanent removal of data can be performed by emptying the trashcan entirely or by purging files based on naming patterns and age thresholds.

AI search

Explore more awesome repositories

Describe what you need in plain English — the AI ranks thousands of curated open-source projects by relevance.

Start searching with AI

Features

  • Command-Line File Operations - Provides shell commands to move files to a system trash folder instead of permanent deletion.
  • Command Line Interfaces - Provides a structured command-line interface for automated trash management operations.
  • Path Restoration - Uses metadata sidecar files to map and restore deleted items to their original absolute file paths.
  • Trashcan Migration - Sends files and directories to the system trashcan according to standard specifications.
  • Trash-Based Deletions - Provides utilities for moving files to the system trash, listing deleted items, and restoring them.
  • XDG Specification Compliance - Adheres to the XDG trash directory layout and metadata standards for cross-desktop interoperability.
  • Trash-Based File Recovery - Restores previously deleted files and directories from the system trashcan back to original locations.
  • Trash Recovery Interfaces - Provides a tool for recovering files from the system trashcan using original paths and timestamps.
  • Trashcan Restoration - Returns deleted files from the trashcan to their original locations with overwrite options.
  • Trash Managers - Manages the lifecycle of deleted items within the FreeDesktop trashcan, including restoration and removal.
  • Trashcan Management Tools - Implements a command line interface for managing files and directories within the FreeDesktop.org trashcan specification.
  • Trash Emptying - Provides a function to delete all files in the trashcan to immediately free up storage space.
  • Recursive File Listing - Displays all files in the trashcan along with their original paths and deletion timestamps.
  • Storage Reclamation Utilities - Includes utilities to permanently purge old or specific files from the trash to reclaim disk space.
  • Age-Based Purging - Allows the permanent removal of files from the trashcan based on a specific age threshold.
  • Name Pattern Filters - Allows the identification and purging of trash entries using name-based matching patterns.
  • Pattern-Based File Deletions - Removes files matching user-defined patterns or age conditions from the trash.
  • Pattern-Based Purging - Permanently removes items from the trashcan that match a specific filename pattern.
  • Temporal File Expiry - Calculates file age using deletion timestamps in metadata to support time-based purging.
4,414 stars·203 forks·Python·GPL-2.0·21 views

Star history

Star history chart for andreafrancia/trash-cliStar history chart for andreafrancia/trash-cli

How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.

Projects sharing features with Trash Cli

These projects share indexed features with Trash Cli. Shared tags can include platform or build tooling; verify the primary use case before treating a result as a replacement.
  • you-dont-need/you-dont-need-guiyou-dont-need avatar

    you-dont-need/You-Dont-Need-GUI

    5,821View on GitHub↗

    You-Dont-Need-GUI is a curated reference of terminal commands that replace common graphical interface operations with equivalent shell one-liners. It maps everyday GUI actions—file management, archive handling, system monitoring, and network diagnostics—to standard POSIX utilities like find, grep, and awk, all composed as self-contained shell pipelines. The project distinguishes itself by requiring no external dependencies or installations; every solution runs with built-in shell commands and coreutils. Its documentation follows Unix man-page conventions, presenting each command with a

    clicommandcommand-line
    View on GitHub↗5,821
  • alienator88/pearcleaneralienator88 avatar

    alienator88/Pearcleaner

    13,583View on GitHub↗

    Pearcleaner is a system maintenance utility designed to reclaim disk space on macOS by identifying and removing residual files left behind after software uninstallation. It functions as an application uninstaller and storage management tool, ensuring that configuration files, caches, and support data are purged to maintain a clean system state. The application distinguishes itself through event-driven automation, utilizing kernel-level monitoring to detect when files are moved to the trash and triggering immediate scans for orphaned data. It integrates directly into the desktop environment vi

    Swift
    View on GitHub↗13,583
  • tw93/miaoyantw93 avatar

    tw93/MiaoYan

    7,578View on GitHub↗

    MiaoYan is a local Markdown editor and personal knowledge management tool. It functions as a system for writing and organizing documents stored as local files, supporting the creation of a connected information network through bidirectional links and backlinks. The project includes a specialized tool for converting Markdown documents into slide-based presentations by using specific content separators. It also provides a command-line interface for managing files, allowing users to create, search, and open documents without a graphical file explorer. The editor features a side-by-side live pre

    Swifteditorlocal-firstmacos
    View on GitHub↗7,578
  • archivebox/archiveboxArchiveBox avatar

    ArchiveBox/ArchiveBox

    26,876View on GitHub↗

    ArchiveBox is a self-hosted archiving tool designed for personal digital preservation and research data management. It functions as an automated web preservation engine that monitors URL inputs from bookmarks, browser history, or manual entries to capture and store permanent, offline copies of web content. By utilizing headless browser automation, the system renders dynamic web pages to ensure that captured snapshots, PDFs, and media assets remain accurate and accessible even if the original source disappears. The project distinguishes itself through a modular extractor pipeline and a task-qu

    Pythonarchiveboxbackupsbookmark-archiver
    View on GitHub↗26,876
Compare all 30 related projects→

Frequently asked questions

What does andreafrancia/trash-cli do?

trash-cli is a command-line interface for managing files and directories within the FreeDesktop.org trashcan specification. It provides a utility to move files to a system trash folder instead of permanently deleting them, preventing accidental data loss when working in a terminal.

What are the main features of andreafrancia/trash-cli?

The main features of andreafrancia/trash-cli are: Command-Line File Operations, Command Line Interfaces, Path Restoration, Trashcan Migration, Trash-Based Deletions, XDG Specification Compliance, Trash-Based File Recovery, Trash Recovery Interfaces.

Which projects share features with andreafrancia/trash-cli?

Projects with overlapping indexed features include: you-dont-need/you-dont-need-gui — You-Dont-Need-GUI is a curated reference of terminal commands that replace common graphical interface operations with… alienator88/pearcleaner — Pearcleaner is a system maintenance utility designed to reclaim disk space on macOS by identifying and removing… tw93/miaoyan — MiaoYan is a local Markdown editor and personal knowledge management tool. It functions as a system for writing and… archivebox/archivebox — ArchiveBox is a self-hosted archiving tool designed for personal digital preservation and research data management. It… aws/aws-sam-cli — The AWS SAM Command Line Interface is a development toolkit used to define, emulate, and manage the lifecycle of… dnoegel/php-xdg-base-dir — php-xdg-base-dir is a PHP library and system path resolver designed to identify standard filesystem locations for…