funkpower
92b2efbd51
A Quickshell widget for Hyprland, a waybar module and an eww panel, all reading the same JSON from the typikon CLI so none of them touches the network and all three agree. The Quickshell piece is three separable parts: a Typikon singleton that wraps the CLI and re-reads only when the date rolls over, a Theme singleton that takes colours from JSON with a default for every key, and the widget itself. 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. The church date shows beside the civil one whenever they differ, which on the old calendar is always. Forefeasts and afterfeasts get their own line instead of crowding out the commemoration that makes the day.
3.6 KiB
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.