script-wizards / athanor

Athanor is an alchemical layer for Arch and Hyprland, inspired by Western
esotericism and dungeon crawling.
## The Signs
The bar shows the planetary hour. Athanor calculates it from your own sunrise
and sunset and pairs each hour with a tarot trump from the Golden Dawn. Each
machine draws its own card of the day and gets a lockscreen sigil made from its
SSH host key. `athanor draw 3` lays a three-card spread. When a program crashes
you get a notification and `athanor tomb` draws its tombstone.
## The Colors
There are four color schemes. Each one is a stage of the alchemical Magnum
Opus: Umber is *nigredo*, Vellum is *albedo*, Orpiment is *citrinitas* and
Cinnabar is *rubedo*. Switch between them with `athanor transmute`. If you set
`stages = true` they change on their own as the sun moves through the day.
| | |
|---|---|
| | |
| | |
The colors are named after old pigments. Orpiment is a yellow arsenic ore whose
name means gold paint. Cinnabar is the mercury ore that vermilion was ground
from. Body text has at least 7:1 contrast against the background and every
accent has 4.5:1.
Helix, micro and nvim get themes built from the terminal's 16 colors. They
change with the scheme. The installer puts them in place and tells you the line
to add to each editor's config. Lualine has an athanor theme too. Its bar has
no background of its own. Set lualine's `section_separators` and
`component_separators` to `''` to keep the arrows from drawing as loose
triangles.
## The Levels
The seven workspaces are dungeon levels. There's one for each classical planet
and each has its own Doré engraving dithered down to two tones. Set
`levels = false` under `[display]` in `athanor.toml` to keep one plate on all
of them.
The wallpapers are Gustave Doré's wood engravings, dithered to two colors with
Floyd-Steinberg. To make your own from any image you only need ImageMagick:
 [code] 
That draws the image at half of 1920x1080 and doubles every pixel. Doubling keeps
the dither crisp. The two colors are the ground and the ink. Doré's engravings are
all public domain on Wikimedia Commons.
## The Screen
The bar at the bottom is a roguelike status line. `Dlvl` stands for dungeon
level and shows the workspace you're on. `$` is free disk space. `Hp` is the
battery and `T` counts minutes since boot. Notifications show up one at a time
on the top line. `--More--` means more are waiting.
The window titles set into the frames come from the notch, an optional plugin
(see Install).
Super+Shift+E asks before quitting Hyprland. Run `athanor guide` for the rest.
## Install
 [code] 
Athanor keeps its files in `~/.config/athanor`. Outside that folder it only
adds a marked block to the top of your `.zshrc` and your `hyprland.lua`. Your
own settings load after the block and override it.
The prompt names each terminal window after its folder, or after the command
running in it. Set `ATHANOR_TITLE=0` in your `.zshrc` to keep your own titles.
Without Hyprland, `./install.sh shell` installs just the