ru-clock

Little terminal clock with weather, colors, and a few knobs to turn. Think “peaclock but tweak-happy”.

Quick start

./scripts/install.sh   # builds + drops binary in ~/.local/bin, copies sample config
ru-clock               # runs with ~/.config/ru-clock/ru-clock.conf

If you’re not into the installer: cargo run --release.

Controls (while running)

• q / Esc – quit
• p – cycle profiles (Mono Minimal, Synthwave, High Contrast)
• x – compact mode (tiny 3-row digits, trims weather art)
• f – cycle fonts (rounded → slim → block → mini)
• b – toggle colon blink
• Weather toggles: w (on/off), a (ASCII art), m (animate art), i (icon tag), s (summary text), l (location label)
• g – re-geocode geocode_query/location_name from config

Config

Default search order:

1. --config <file>
2. $XDG_CONFIG_HOME/ru-clock/ru-clock.conf (or ~/.config/ru-clock/ru-clock.conf)
3. ru-clock.conf / clock.toml in cwd
4. Built-in defaults

Edit ru-clock.conf (the example ships with blank/fake coords):

• format, tick_ms, font, digit_spacing, glyph_on/off, show_off_segments
• [colors] foreground/background/accent/secondary, duotone = true to alternate colors
• [weather] enabled, latitude/longitude, unit, show_ascii, animate_ascii, show_icon/summary/location, auto_locate, geocode_query

Weather is from Open-Meteo (free, no API key). Geocoding (optional) uses Nominatim.

Profiles

• Mono Minimal (white on transparent, slim font)
• Synthwave (cyan/magenta duotone, rounded font)
• High Contrast (white/yellow on black, block font)

Compact mode

Hit x to drop into mini font + single-line weather. Hit x again to bounce back.

Install

./scripts/install.sh builds release and installs to ~/.local/bin. Make sure that’s on your PATH.

Notes

• Redraws are incremental to keep flicker and CPU low.
• If weather feels laggy, lower refresh_secs or set show_ascii = false.
• Fonts and palettes are easy to add; PRs welcome.