https://github.com/pashkov256/deletor
Manage and delete files efficiently with an interactive TUI and scriptable CLI.
https://github.com/pashkov256/deletor
beginner-friendly cli contribution contributions-welcome golang golang-cli golang-filesystem good-first-contribution good-first-issue good-first-pr hacktoberfest help-wanted open-source tui
Last synced: 28 days ago
JSON representation
Manage and delete files efficiently with an interactive TUI and scriptable CLI.
- Host: GitHub
- URL: https://github.com/pashkov256/deletor
- Owner: pashkov256
- License: mit
- Created: 2025-01-25T16:14:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-04T14:02:28.000Z (29 days ago)
- Last Synced: 2026-04-04T14:54:58.892Z (28 days ago)
- Topics: beginner-friendly, cli, contribution, contributions-welcome, golang, golang-cli, golang-filesystem, good-first-contribution, good-first-issue, good-first-pr, hacktoberfest, help-wanted, open-source, tui
- Language: Go
- Homepage: https://code2tutorial.com/tutorial/3aac813f-99c2-453f-819f-c80e4322e068/index.md
- Size: 576 KB
- Stars: 233
- Watchers: 2
- Forks: 54
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-tuis - deletor
- awesome-opensource-projects - deletor - Interactive TUI and CLI tool for efficient file management (Project Categories)
README
Manage and delete files efficiently with an interactive TUI and scriptable CLI.
Deletor is a handy file deletion tool that combines a powerful text interface (**TUI**) with visual directory navigation, and classic command line mode (**CLI**). With it, you can quickly find and delete files by filters, send them to the trash or completely erase them, as well as clear the cache, both interactively and through scripts.
---
Опенсорсеры - это сообщество разработчиков, здесь любой может поделится своими проектами, получить конструктивный разбор проекта, найти первых контрибьюторов и просто лампово общаться об айти и не только.
Присоеденяйся к нам: t.me/OpenSource_Chat
## Features
- 🖥️ **Interactive TUI**: Modern text-based user interface for easy file navigation and management
- 🖱️ **Mouse Support**: Full mouse support for selection, scrolling, and interaction
- 🔢 **Multi-Selection**: Select multiple files at once for batch operations
- ♻️ **Safe Deletion: Files**: Are moved to the system trash/recycle bin instead of permanent deletion
- 🧹 **OS Cache Cleaner**: Free up space by deleting temporary system cache
- 🛠️ **Deep Customization** Shape the tool to behave exactly how you need
- 🧠 **Rules System**: Save your filter settings and preferences for quick access
- 📖 **Log Operations**: Log the various fields and look at the tui table, or parse the file
- ⏳ **Modification Time Filter**: Delete files older,newer than X days/hours/minutes
- 📏 **Size Filter**: Deletes only files larger than the specified size
- 🗑️ **Extensions Filter**: Deletes files with specified extensions
- 📂 **Directory Navigation**: Easy navigation through directories with arrow keys
- 🎯 **Quick Selection**: Select and delete files with keyboard shortcuts
- ✅ **Confirmation Prompt**: Optional confirmation before deleting files
---
## 📦 Installation
### Using Go
```bash
go install github.com/pashkov256/deletor@latest
```
## 🛠 Usage
### TUI Mode (default):
```bash
deletor
```
### CLI Mode (with filters):
```bash
deletor -cli -d ~/Downloads -e mp4,zip --min-size 10mb -subdirs --exclude data,backup
```
### Dev launch:
```bash
go run . -cli -d ~/Downloads -e mp4,zip --min-size 10mb -subdirs --exclude data,backup
```
### ⚙️ CLI Flags
| Flags | Description |
|----------------|-----------------------------------------------------------------------------|
| `-e` | Comma-separated list of extensions (e.g., `mp4,zip,jpg`). |
| `-d` | Path to the file search directory. |
| `--min-size` | Minimum file size to delete (e.g., `10kb`, `1mb`, `1gb`). |
| `--max-size` | Maximum file size to delete (e.g., `10kb`, `1mb`, `1gb`). |
| `--older` | Modification time older than (e.g., `1sec`, `2min`, `3hour`, `4day`). |
| `--newer` | Modification time newer than (e.g., `1sec`, `2min`, `3hour`, `4day`). |
| `--exclude` | Exclude specific files/paths (e.g., `data`, `backup`). |
| `-subdirs` | Include subdirectories in scan. Default is false. |
| `-prune-empty` | Delete empty folders after scan. |
| `-rules` | Running with values from the rules |
| `-progress` | Display a progress bar during file scanning. |
| `-skip-confirm`| Skip the confirmation of deletion. |
## ✨ The Power of Dual Modes: TUI and CLI
- TUI mode provides a user-friendly way to navigate and manage files visually, ideal for manual cleanups and exploration.
- CLI mode is perfect for automation, scripting, and quick one-liners. It's essential for server environments, cron jobs, and integrating into larger toolchains.
## 🛠 Contributing
We welcome and appreciate any contributions to Deletor!
There are many ways you can help us grow and improve:
- **🐛 Report Bugs** — Found an issue? Let us know by opening an issue.
- **💡 Suggest Features** — Got an idea for a new feature? We'd love to hear it!
- **📚 Improve Documentation** — Help us make the docs even clearer and easier to use.
- **💻 Submit Code** — Fix a bug, refactor code, or add new functionality by submitting a pull request.
Before contributing, please take a moment to read our [CONTRIBUTING.md](https://github.com/pashkov256/deletor/blob/main/CONTRIBUTING.md) guide.
It explains how to set up the project, coding standards, and the process for submitting contributions.
Together, we can make Deletor even better! 🚀
## AI docs
https://code2tutorial.com/tutorial/3aac813f-99c2-453f-819f-c80e4322e068/index.md
## 📜 License
This project is distributed under the **MIT** license.
---
### Thank you to these wonderful people for their contributions!
