🌰 Hazelnut

A beautiful terminal-based file organizer
inspired by Hazel

Watch folders and automatically organize files with flexible rules — all from your terminal with a gorgeous TUI.

brew install ricardodantas/tap/hazelnut

cargo install hazelnut

hazelnut

Features

📁

Monitor directories for new and changed files in real-time. Set up multiple watch locations with different rules.

🎯

Create powerful rules with conditions based on file name, type, size, age, and more using glob patterns or regex.

⚡

Move, copy, rename, archive, delete, or run custom scripts on matched files. Chain actions together.

🖥️

Manage rules and monitor activity through an intuitive terminal interface with 15 gorgeous themes.

🔧

The daemon runs quietly in the background, processing files automatically as they appear.

🔔

Get alerted when something goes wrong. Cross-platform support for Linux, macOS, and Windows.

[[rule]]
name = "Screenshots"

[rule.condition]
name_matches = "Screenshot*.png"

[rule.action]
type = "move"
destination = "~/Pictures/Screenshots"

[[rule]]
name = "Clean old downloads"

[rule.condition]
age_days_greater_than = 30

[rule.action]
type = "trash"

[[rule]]
name = "Move PDFs"

[rule.condition]
extension = "pdf"

[rule.action]
type = "move"
destination = "~/Documents/PDFs"

Customize your experience with gorgeous color schemes including Dracula, Nord, Tokyo Night, and more.

Hazelnut needs watch folders (where to look) and rules (what to do). Both are required!

brew install ricardodantas/tap/hazelnut

or cargo install hazelnut

Edit ~/.config/hazelnut/config.toml — see docs for examples

hazelnutd start

hazelnut