Ianny | عَيْنِي

Simple, light-weight, easy to use, and effective Linux Wayland desktop utility helps preventing repetitive strain injuries by keeping track of usage patterns and periodically informing user to take breaks.

---

Install


Contribute


Packaging

---

Features

• ⚙ Simple config to tweak it's behavior.
• 🚀 Auto start it with your desktop environment.
• 🚫 X11 is not supported.
• 🚫 Microsoft Windows is definitely not supported.

Requirements

• Wayland Compositor that implements ext_idle_notifier_v1
• Notification Daemon that implements org.freedesktop.Notifications
• libdbus-1.so installed in your system
• Linux libc via either glibc or musl libc

Installation

Download Binary From Github

For every new release a Github workflow will build a binary in Github servers and will upload it as a release asset in Github releases.

You can find the latest Github release here or the releases page here.

Build

Note

You need to have cargo, meson and libdbus-1-dev installed in you system.

git clone https://github.com/zefr0x/ianny.git

cd ianny

# Checkout to a release tag e.g. v1.0.1
git checkout vx.x.x

meson build
meson compile -C build

You will find the binary in ./build/src/ianny

To install:

meson install -C build

Usage

You just need to execute the binary eather direcrly or by enabling it to auto-start with your desktop environment's settings, since it provides a .desktop file for auto-start.

Config

The defaults might not fit your needs, so you can change them via a config file.

The config file is $XDG_CONFIG_HOME/io.github.zefr0x.ianny/config.toml or by default ~/.config/io.github.zefr0x.ianny/config.toml. Just create it and specify the options you need with the toml format:

[timer]
idle_timeout = 240
short_break_timeout = 1200
long_break_timeout = 3840
short_break_duration = 120
long_break_duration = 240

[notification]
show_progress_bar = true
minimum_update_delay = 1

Note

Time specified in seconds

Q&A

Q: What does Ianny mean?

• It is an Arabic word عَيْنِي that could be translated to My Eye in english.

Inspired by

• KDE's RSIBreak