🗂️ Tooka

A fast, rule-based CLI tool for organizing files.

🧭 Introduction

Tooka is a flexible command-line tool for automating your filesystem: organize, rename, move, copy, or delete files using simple, powerful YAML rules.

You define what files to match (by name, extension, metadata, size, etc.) and what should happen to them — Tooka handles the rest with blazing-fast parallel processing.

✨ Features

• 🎯 Rule-based automation - Define custom file organization rules using declarative YAML
• ⚡ High-performance - Parallel recursive directory traversal and file operations
• 🔍 Flexible filtering - Match files by name patterns, extensions, MIME types, size, metadata, and timestamps
• 🛠️ Multiple actions - Move, copy, rename, delete, or skip files based on conditions
• 📝 Template support - Dynamic file naming with customizable templates
• 🔒 Safe operations - Dry-run mode and comprehensive logging for safety
• 🌐 Cross-platform - Works seamlessly on Windows, macOS, and Linux

🤝 Contributing

We welcome contributions! Please see:

• Contributing Guidelines
• Code of Conduct
• GitHub Discussions for ideas and questions

💬 Community & Support

• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Discussions
• 📋 Quick Feedback: Feedback Form (no account needed)
• 📖 Documentation: Wiki

📜 License

Licensed under GPLv3