lab421 / forel

# Forel
**The Hazel alternative for macOS. Open source and privacy-focused.**
**New** · project from the Forel team — check out Ombrelle →
This project is built and maintained on my personal time. A ⭐ on the repo is the simplest way to say thanks and helps Forel get discovered by others who might need it. For anyone who wants to go further, you can support the work with a buy me a coffee ☕ 
> **Open source, 100% on-device**
**Install with Homebrew:**
 [code] 
## Why Forel
Forel is an open-source, community-driven take on folder automation for macOS.
Define rules once watch folders, match files, and move, rename, tag, or label them automatically then let Forel run quietly in your menu bar.
---
## What Forel does
Forel watches your folders and organizes your files automatically based on rules you define — by filename, extension, kind, size, date, tags, color label, or file contents. On-device OCR lets you match text in images and scanned PDFs, too.
 [code] 
Set up a rule once. Forel handles the rest — even when the window is closed.
File matching and processing happen **locally on your Mac**. Forel does not upload your files to a processing service. Your configured destinations and scripts determine where files go, including network volumes.
---
## Highlights
- **Open source (GPLv3)** — source code available, community-driven development.
- **On-device processing** — file matching and OCR run locally, without a cloud processing service or AI API keys.
- **Rule-based** — match by name, extension, kind, size, date, tags, color label, or file contents.
- **Native menu-bar app** — runs quietly in the background; toggle rules without opening the window.
- **Community-driven** — built in the open, contributions welcome.
---
## Features
- **Rule-based automation** — Create flexible rules combining filename patterns, file types, sizes, dates, tags, and Finder color labels.
- **Content matching & OCR** — Match text inside documents, images, and scanned PDFs using local extraction and on-device OCR. See Content matching for supported formats and limits.
- **Folder watching** — Monitor any number of folders in real time with native macOS FSEvents.
- **Dry Run & Run Now** — Preview matching files and planned actions without changing files, then run rules manually on existing files when ready.
- **History & Undo** — Review action results and undo supported actions when it is safe to do so.
- **Menu bar app** — Forel lives in your menu bar. Toggle individual rules on/off without opening the main window.
- **Actions** — Move, copy, rename, tag, trash, delete, or run a custom script.
- **SQLite persistence** — Rules, folders, and history are stored locally in a bundled SQLite database.
---
## Installation
### Homebrew
 [code] 
or
 [code] 
### Manual
Download the latest release `.dmg` from the Releases page, open it, and drag Forel to your Applications folder.
### Build from source
**Prerequisites:** Swift 6 · macOS 14 or later
 [code] 
To build and package the app