# pryr 🕌
> A blazing-fast, uncompromising Islamic prayer time daemon and screen locker for Linux and Windows.
Notifications are too easy to dismiss when you're deep in a coding session. **`pryr` doesn't just remind you to pray; it forces you.** Built entirely in Rust, `pryr` runs silently in the background. It calculates daily prayer times, sends escalating desktop warnings, and when Iqamah hits, it ruthlessly locks your session for a configurable duration. You cannot dismiss it. You can only go pray.
---
### ✨ Features
- **Uncompromising Lockdown:** Stubbornly locks your screen during Iqamah. If you unlock it early, it instantly locks it again until the duration is over.
- **Escalating Warnings:** Native desktop notifications before lockdown at configurable intervals (default: 5 minutes and 2 minutes before Iqamah).
- **Configurable Lockdown Boundaries:** Fine-tune exactly when warnings fire, when the lockdown begins, and how long after Iqamah the session stays locked.
- **Zero-Overhead IPC:** A lightning-fast CLI (`pryr`) communicates with the background daemon (`pryrd`) via Unix Domain Sockets (Linux) or Named Pipes (Windows).
- **Dynamic Configuration:** Update your location and calculation methods on the fly using the CLI, or adjust Iqamah offsets via a simple TOML file. Hot-reloads without dropping the daemon.
- **Native Screen Locking:** Uses `loginctl` on Linux (Wayland/X11) and the native `LockWorkStation` API on Windows to cleanly and forcefully lock your device.
- **Self-Updating:** `pryr` can update itself to the latest version with a single command.
---
### 🚀 Installation
`pryr` is distributed as pre-compiled binaries for Linux and Windows (x86_64). You don't need Rust installed to run it.
#### Linux
Run the following command to download the latest release, add it to your `$PATH`, and automatically set up the systemd background service:
```bash
```
_(Note: Requires `systemd` and `loginctl` to be present on your system)._
#### Windows
Open PowerShell and run the following command to download the release, add it to your `PATH`, and register the silent logon background task via the Windows Task Scheduler:
```powershell
```
---
### 💻 Usage
The `pryr` CLI acts as a remote control for the background daemon.
```bash
# Set your location, calculation method, and Madhab (automatically fetches coordinates)
pryr configure --city "Suez, Egypt" --method egyptian --madhab shafi
# View the full schedule for today (Adhan and Iqamah times)
pryr schedule
# Get the live countdown to the next prayer or lockdown event
pryr status
# Output schedule or status as raw JSON (useful for scripting and integrations)
pryr schedule --json
pryr status --json
# Reload the configuration file dynamically without restarting the daemon
pryr reload-config
# Update pryr to the latest version
pryr update
```
#### Example Output:
```text
┌─ Today's Prayer Schedule
Prayer Adhan Iqamah
─────────────────────────────────────
✓ Fajr 04:45 AM 05:05 AM
✓ Dhuhr 12:05 PM 12:20 PM
○ Asr 03:32 PM 03:47 PM
○ Maghrib 06:01 PM 06:11 PM
○ Isha 07:20 PM 07:35 PM
└───────────────────────────────────────
```
Pass `--json` to get machine-readable output instead:
```bash
pryr schedule --json
```
```json
{"DailySchedule":{"fajr":{"prayer_time":"2026-03-10T04:45:00Z","iqamah_time":"2026-03-10T05:05:00Z"},"dhuhr":{"prayer_time":"2026-03-10T12:05:00Z","iqamah_time":"2026-03-10T12:20:00Z"},"asr":{"prayer_time":"2026-03-10T15:32:00Z","iqamah_time":"2026-03-10T15:47:00Z"},"maghrib":{"prayer_time":"2026-03-10T18:01:00Z","iqamah_time":"2026-03-10T18:11:00Z"},"isha":{"prayer_time":"2026-03-10T19:20:00Z","iqamah_time":"2026-03-10T19:35:00Z"}}}
```
---
### ⚙️ Configuration
On first run, `pryr` automatically generates a default configuration file based on your operating system:
- **Linux:** `~/.config/pryr/config.toml`
- **Windows:** `%APPDATA%\pryr\config.toml` _(usually `C:\Users\YourName\AppData\Roaming\pryr\config.toml`)_
The easiest way to update your location is using the `pryr configure` command, which automatically queries a geocoding API to find your latitude and longitude and updates the daemon instantly.
For fine-grained control over your Iqamah delays or screen-locking behavior, you can manually edit the `config.toml` file:
```toml
[location]
lat = 29.9668
long = 32.5498
[prayer-config]
method = "Egyptian"
madhab = "Shafi"
[iqamah-offset]
fajr = 20
dhuhr = 15
asr = 15
maghrib = 10
isha = 15
[options]
# Set to false to only receive notifications without locking the screen
lock-screen = true
[lockdown]
# Minutes before Iqamah to show the first warning notification (default: 5)
warning-before-iqamah = 5
# Minutes before Iqamah to initiate the screen lock (default: 2)
lock-before-iqamah = 2
# Minutes after Iqamah before the screen is unlocked (default: 10)
unlock-after-iqamah = 10
```
After manually modifying the file, simply run `pryr reload-config` to instantly apply the new math.
---
### 🏗️ Architecture
`pryr` is built with a decoupled Client-Server architecture to ensure maximum performance and zero missed events:
1. **`pryrd` (The Heart):** A Tokio-powered asynchronous state machine. It handles time math, schedules system sleeps, executes lockdowns, and broadcasts state changes via an `mpsc` watch channel. It runs invisibly via `systemd` (Linux) or Task Scheduler (Windows).
2. **The Nerves:** `pryrd` binds to `/run/user/$UID/pryr.sock` (Linux) or `\\.\pipe\pryr-ipc` (Windows). It listens for Newline-Delimited JSON requests and responds instantly using zero-cost cached data.
3. **`pryr` (The Face):** A lightweight, synchronous CLI built with `clap`. It connects to the socket/pipe, sends remote procedure calls, formats the JSON response with `owo-colors`, and exits in milliseconds. (Network requests, like geocoding a city, are strictly isolated to the CLI to keep the daemon purely offline).
---
### 📝 License & Author
Developed by **Mostafa Mahmoud**.
This project is licensed under the MIT License - see the [LICENSE](https://www.google.com/search?q=LICENSE) file for details.