iris-cli

Crates.ioiris-cli
lib.rsiris-cli
version1.3.1
created_at2025-12-27 08:51:40.054687+00
updated_at2025-12-29 05:45:45.346323+00
descriptionSmart file organization
homepagehttps://github.com/lordaimer/iris
repositoryhttps://github.com/lordaimer/iris
max_upload_size
id2006893
size261,639
Arane Aimer (lordaimer)

documentation

README

Iris

GitHub Release GitHub Actions Workflow Status Crates.io License

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.toml file.

  • 📄 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
Commit count: 0

cargo fmt