# deletor

> File deletion tool with interactive TUI and CLI modes supporting filters, trash integration, and batch operations.

Stars: 261 · Categories: File Management

- Repository: https://github.com/pashkov256/deletor
- Website: https://code2tutorial.com/tutorial/3aac813f-99c2-453f-819f-c80e4322e068/index.md
- Page: https://www.trmn.sh/tools/deletor

## Install

- Go: `go install github.com/pashkov256/deletor@latest`

## Overview

Deletor is a file deletion tool that operates in two modes: an interactive text-based user interface (TUI) and a scriptable command-line interface (CLI). The TUI mode provides visual directory navigation with mouse support and keyboard shortcuts for file selection, while the CLI mode enables automation through filtering options and batch operations.

The tool supports comprehensive file filtering including extensions, size ranges, modification time criteria, and path exclusions. Files can be moved to the system trash or permanently deleted, with optional confirmation prompts. Additional features include multi-file selection, empty directory pruning, operation logging, and OS cache cleaning capabilities.

Deletor targets both interactive users who need visual file management and system administrators requiring scriptable file cleanup operations. The CLI mode supports integration into automation workflows, cron jobs, and shell scripts with flags for size filtering (e.g., --min-size 10mb), time-based deletion (e.g., --older 7day), and extension matching (e.g., -e mp4,zip). A rules system allows saving filter configurations for repeated use.

### Installation

```bash
# via Go
go install github.com/pashkov256/deletor@latest
```

![Deletor TUI interface demonstration](https://media.trmn.sh/cached/0cd0915083dd3a2de2b47d4c4c6c3627e828e3bc6732146768bead4af31035ca.gif)

## Alternatives

- [hazelnut](https://www.trmn.sh/tools/hazelnut.md): Terminal-based automated file organizer that watches folders and applies rules to move, copy, rename, or delete files based on patterns (Rust, 327 stars)
- [cull](https://www.trmn.sh/tools/cull.md): Interactive TUI disk space analyzer for scanning directories, finding large files, and deleting them from the terminal. (168 stars)
- [bt](https://www.trmn.sh/tools/bt.md): TUI file manager with tree-based navigation for manipulating files and directories in terminal (167 stars)
- [bkp](https://www.trmn.sh/tools/bkp.md): Simple command-line utility for creating numbered backups of files and directories with optional TAR archiving. (24 stars)
- [notox](https://www.trmn.sh/tools/notox.md): CLI tool for renaming files to remove toxic or problematic characters from filenames (Rust, 16 stars)

---

Canonical: https://www.trmn.sh/tools/deletor