Skip to content

Install

itero runs on macOS (Apple Silicon and Intel) and Linux (x86_64 and aarch64).

Terminal window
brew install aegea-dev/tap/itero

The formula puts Itero.app, the macOS notifier, in its own folder, where itero finds it.

Terminal window
curl -fsSL https://raw.githubusercontent.com/aegea-dev/itero/main/install.sh | sh

The script downloads a release, checks the archive’s SHA-256 before unpacking it, installs itero to ~/.local/bin and, on macOS, Itero.app to ~/Applications. It never edits your shell profile: if ~/.local/bin is not on your PATH, it says so.

OptionDoes
--version X.Y.Zinstalls that release instead of the latest
--to DIRinstalls itero to DIR
--uninstallremoves what it installed

Pass options after sh -s --:

Terminal window
curl -fsSL https://raw.githubusercontent.com/aegea-dev/itero/main/install.sh | sh -s -- --version 0.1.0

With a Rust toolchain:

Terminal window
git clone https://github.com/aegea-dev/itero
cd itero
make install

make install installs itero to ~/.cargo/bin and, on macOS, builds Itero.app and puts it in ~/Applications.

On macOS, notifications come from Itero.app, which asks once to be allowed to show them and then has its own entry in System Settings, Notifications. Without the app they go through osascript and show as Script Editor’s.

On Linux, itero uses the first of notify-send (libnotify), gdbus (the freedesktop notification service) and kdialog (KDE) that it finds.

Terminal window
itero --version

Next: the quickstart.