sigye-0.4.1 is not a library.

sigye (시계)

A feature-rich terminal clock with ASCII art fonts, animated backgrounds, and productivity timers. The name "sigye" (시계) means "clock" in Korean.

sigye demo

Features

5 display modes — Clock, Pomodoro, Timer, Stopwatch, and World Clock
40+ bundled FIGlet fonts — From classic Standard to stylish Star Wars
18 color themes — 7 static colors and 11 gradient palettes
5 animation styles — None, Shifting, Pulsing, Wave, and Reactive
20+ animated backgrounds — Starfield, matrix rain, weather effects, cherry blossoms, and system-reactive visuals
Desktop notifications — Alerts for Pomodoro phase changes and timer completion
Live weather backgrounds — Auto-selects rain, snow, fog, or sun based on real conditions via wttr.in
System-reactive backgrounds — CPU, memory, network, and disk metrics drive visual effects
World Clock — Display multiple timezones simultaneously
CLI arguments — Launch directly into any mode, theme, font, or background
Screensaver and demo modes — Fullscreen ambient display or auto-cycling showcase
12/24 hour format — Toggle with a single keypress
Live settings preview — See changes in real time before saving
Persistent configuration — Settings saved automatically to TOML
Custom font support — Drop FIGlet .flf files into ~/.config/sigye/fonts/

How sigye Compares

Feature	sigye	tty-clock	peaclock	clock-tui	timr-tui
Maintained	Active	2021	2020	Active	Active
Language	Rust	C	C++	Rust	Rust
Clock	Yes	Yes	Yes	Yes	Yes
Pomodoro	Yes	--	--	--	Yes
Timer	Yes	--	Yes	Yes	Yes
Stopwatch	Yes	--	Yes	--	Yes
World Clock	Yes	--	--	--	--
FIGlet Fonts	40+	1	3	1	7
Color Themes	18	8	256	Basic	Basic
Animated Backgrounds	20+	--	--	--	--
Live Weather	Yes	--	--	--	--
System-Reactive	Yes	--	--	--	--
Desktop Notifications	Yes	--	--	--	Yes*
Screensaver Mode	Yes	Yes	--	--	--
Config File	TOML	--	Yes	--	Yes
Cross-Platform	Yes	Linux	Linux	Yes	Yes

Installation

From crates.io

cargo install sigye

From source

git clone https://github.com/am2rican5/sigye
cd sigye
cargo install --path crates/sigye

Usage

sigye

Press s to open the settings dialog, or use the keybindings below to adjust on the fly.

CLI Options

sigye [OPTIONS]

Options:
  --screensaver      Fullscreen ambient mode (no UI chrome)
  --demo             Auto-cycle themes, backgrounds, and fonts
  --font <NAME>      Set font (e.g., "Standard", "Banner", "Doom")
  --theme <NAME>     Set color theme (e.g., "neon", "fire", "aurora")
  --bg <NAME>        Set background (e.g., "matrix", "aurora", "weather")
  --mode <MODE>      Set display mode (clock, pomodoro, timer, stopwatch, worldclock)
  --tz <LABEL=TZ>    Add world clock timezone (repeatable)
  -h, --help         Print help
  -V, --version      Print version

Examples

sigye --screensaver --bg aurora --theme neon
sigye --demo
sigye --mode worldclock --tz "Seoul=Asia/Seoul" --tz "Berlin=Europe/Berlin"
sigye --mode pomodoro --font Doom --theme fire

Keybindings

Global

Key	Action
`q` / `Esc`	Quit
`m`	Cycle display mode (Clock / Pomodoro / Timer / Stopwatch / World Clock)
`t`	Toggle 12/24 hour format
`c`	Cycle color theme
`a`	Cycle animation style
`b`	Cycle background style
`s`	Open settings dialog
`?`	Show help overlay

Pomodoro Mode

Key	Action
`Space`	Pause / resume
`r`	Reset current phase
`n`	Skip to next phase

Timer Mode

Key	Action
`Space`	Pause / resume
`r`	Reset timer
`+` / `=`	Add time
`-`	Subtract time

Stopwatch Mode

Key	Action
`Space`	Pause / resume
`r`	Reset stopwatch
`l`	Record lap

Settings Dialog

Key	Action
`Up` / `k`	Previous field
`Down` / `j`	Next field
`Left` / `h`	Previous value
`Right` / `l`	Next value
`Enter`	Save settings
`Esc`	Cancel

Configuration

Settings are stored at ~/.config/sigye/config.toml:

font_name = "Standard"
color_theme = "Cyan"
time_format = "TwentyFourHour"
animation_style = "None"
animation_speed = "Medium"
colon_blink = false
show_seconds = true
background_style = "None"
weather_location = ""          # Empty for auto-detect, or city name (e.g., "Seoul")
pomodoro_work_mins = 25
pomodoro_break_mins = 5
pomodoro_long_break_mins = 15
pomodoro_sessions_until_long = 4
pomodoro_sound = true

World Clock

Add timezones to display in World Clock mode:

world_clock_zones = [
    "New York=America/New_York",
    "London=Europe/London",
    "Tokyo=Asia/Tokyo",
    "Seoul=Asia/Seoul",
]

Custom Fonts

Place FIGlet font files (.flf) in ~/.config/sigye/fonts/ and they will appear in the settings dialog.

Color Themes

Static Colors

Cyan, Green, White, Magenta, Yellow, Red, Blue

Dynamic Gradients

Theme	Description
Rainbow	Horizontal rainbow spectrum
Rainbow V	Vertical rainbow
Warm	Red to Orange to Yellow
Cool	Blue to Cyan to Green
Ocean	Dark Blue to Cyan to Teal
Neon	Magenta to Cyan (synthwave)
Fire	Dark Red to Orange to Yellow
Frost	White to Ice Blue to Steel Blue
Aurora	Green to Cyan to Blue to Purple
Winter	Deep Blue to Royal Blue to Ice Blue
Sakura	Sakura Pink to Lavender Blush

Background Styles

Classic

Style	Description
Starfield	Twinkling stars with varying brightness
Matrix	Falling green Matrix-style characters
Gradient	Flowing diagonal color wave

Weather & Atmospheric

Style	Description
Weather	Auto-selects based on real-time conditions via wttr.in
Sunny	Radiant sun with animated rays
Cloudy	Layered drifting clouds
Foggy	Ground-hugging mist effect
Rainy	Falling rain droplets
Stormy	Rain with lightning flashes
Windy	Horizontal wind streaks
Snowfall	Drifting snowflakes in shades of blue
Frost	Ice crystals growing from screen edges
Aurora	Northern lights in green, cyan, blue, and purple

Twilight & Seasonal

Style	Description
Dawn	Sunrise gradient with fading stars
Dusk	Sunset gradient with emerging stars
Sakura	Cherry blossom petals drifting down

System-Reactive

Driven by real-time system metrics (CPU, memory, network, disk):

Style	Description
Sys Pulse	CPU usage drives pulsing rings from center
Resource	Memory usage controls wave amplitude
Data Flow	Network I/O drives particle density
Heat Map	Combined metrics as color intensity

Bundled Fonts

3D-ASCII, Acrobatic, Alligator, Alphabet, ANSI Regular, ANSI Shadow, Avatar, Banner, Bell, Big, Big Money-ne, Block, BlurVision ASCII, Chunky, Colossal, Doh, Doom, Electronic, Epic, Graffiti, Ivrit, Larry 3D, Lean, Mini, Mono 9, Mono 12, Ogre, Poison, Puffy, Rebel, Rectangles, Script, Shadow, Slant, Small, Speed, Standard, Star Wars, Terrace, Tmplr

Contributing

git clone https://github.com/am2rican5/sigye
cd sigye
cargo build
cargo test --workspace
cargo fmt -- --check
cargo clippy

License

This project is licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT)

sigye 0.4.1