4 stable releases
| 1.3.1 | Dec 29, 2025 |
|---|---|
| 1.3.0 | Dec 28, 2025 |
| 1.2.0 | Dec 28, 2025 |
| 1.1.1 | Dec 27, 2025 |
#890 in Filesystem
225KB
2.5K
SLoC
Iris
A fast, minimal, config-driven file organizer built with Rust.
Iris helps you sort and organize your messy folders automatically using defined rules.
Features
- ⚡ Fast: Built in Rust for high performance.
- 💻 Multiplatform: Runs on Windows, Linux, and macOS.
- 🖱️ Context Menu: Right-click "Sort with Iris" support on Windows.
- 📁 Config Driven: Customize behavior with a simple
iris.tomlfile. - 📄 Shell Completion: Support for shell completion scripts.
- 🤖 Smart Presets: Comes with sensible defaults for common file types.
Installation
Download Binary
Download the latest release for your platform from the Releases Page.
From Crates.io
cargo install iris-cli
Usage
Basic Sorting
To sort a directory using default settings:
iris sort /path/to/folder
Windows Context Menu
On Windows, you can add Iris to the right-click menu:
iris context install
Now simply right-click any folder background and select "Sort with Iris".
Demo: Windows Context Menu
Configuration
Iris automatically creates a default configuration file at:
- Windows:
%APPDATA%\Iris\iris.toml - Linux/macOS:
~/.config/iris/iris.toml
Can be customized to define where files go based on extensions or patterns.
iris config edit
[preset.images]
enabled = true
# Sorts .jpg and .png into "Pictures" folder
extension = ["jpg", "png"]
relative_path = "Pictures"
Shell Completion
Automatically generate and install completion scripts for your shell. You can also generate the completion script manually and install it yourself with iris completions <SHELL> command.
iris completions install
Dependencies
~7–20MB
~283K SLoC