horologion

Desktop front ends for typikon — the Orthodox liturgical day on your desktop, in Hyprland (Quickshell), waybar or eww.

Everything is computed locally by typikon, so none of this touches the network, and the widget re-reads only when the date rolls over — the answer changes at midnight and at no other moment.

Install

typikon first, since all three front ends shell out to it:

$ pip install typikon
$ typikon --set-default rocor     # or antiochian, oca, greece, ...

Then:

$ git clone https://git.pumpin.online/funkpower/horologion
$ cd horologion && ./bin/horologion-install

That links rather than copies, so git pull updates what you are running. Pass quickshell, waybar, eww or bin to do just one.

Quickshell

A desktop widget for Hyprland and anything else Quickshell runs on.

$ quickshell -p ~/.config/quickshell/horologion/shell.qml

It sits on the background layer, so it behaves like part of the wallpaper — always under your windows, never stealing a click.

To drop it into a shell you already have:

import qs.horologion.modules

Horologion {}

Three pieces, each usable on its own:

services/Typikon.qml	a singleton wrapping the CLI — bind to it from anything
services/Theme.qml	colours, from JSON, with defaults for every key
modules/Horologion.qml	the widget

Set a jurisdiction per-widget if you want one different from your default:

Horologion {
    Component.onCompleted: Typikon.jurisdiction = "moscow"
}

Colours

Theme.qml reads ~/.config/horologion/colors.json, or whatever HOROLOGION_COLORS points at, and watches it for changes. Every key has a default, so the widget is legible with no file at all. See quickshell/colors.example.json — the flat shape most theme generators already emit.

waybar

"custom/typikon": {
    "exec": "horologion-waybar",
    "return-type": "json",
    "interval": 1800,
    "on-click": "typikon --days 7"
}

The module's CSS class is the fast level — .xerophagy, .wine_oil, .fish — so a day's discipline reads off the colour without reading the text. .obligatory is added only where a particular law actually binds, which under the Typikon is never: the Orthodox Church keeps the fast as tradition, not as precept. waybar/style.css has a starting palette.

Change what the text says with --format:

$ horologion-waybar --format '{emoji} {fastLabel}'
$ horologion-waybar -j moscow --format '{emoji} {churchDate}'

eww

(include "horologion/horologion.yuck")

Then (horologion) for the full panel or (horologion-bar) for one line. horologion.scss carries the styling; its colours are !default variables, so set your own before the @import.

What it shows

The feast or the day's principal commemoration, the fast and why, the season, the week ahead, and Pascha. Two details worth pointing out:

• The church date appears beside the civil one whenever they differ, which on the old calendar is always. 25 December and 7 January are the same feast.
• Forefeasts, afterfeasts and leave-takings get their own quiet line rather than crowding out the commemoration that makes the day itself. They repeat for days at a time.

The legend is built from the week in view rather than hardcoded, because the levels a tradition uses are its own — six under the Typikon, three under Ruthenian particular law — and the words for them differ too.

Licence

GPL-2.0-only — see LICENSE.