🗂️ 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