andreafrancia/trash-cli
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.
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.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
