sigye (시계)

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

Features

• 5 display modes — Clock, Pomodoro, Timer, Stopwatch, and World Clock
• Developer clock formats — Unix timestamp, ISO 8601, and hex time display (cycle with f)
• Clipboard hotkeys — Copy unix timestamp (u) or ISO 8601 (i) to clipboard instantly
• Day & year progress bars — Ambient progress indicators at a glance
• Scriptable output — sigye --once --format unix for shell pipelines
• 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

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)
  --once                 Print time once and exit (no TUI)
  --format <FORMAT>      Output format for --once (human, unix, iso, hex) [default: human]
  -h, --help             Print help
  -V, --version          Print version

Examples

# Scripting & developer use
sigye --once                                    # Print current time and exit
sigye --once --format unix                      # Print unix timestamp (e.g., 1743494400)
sigye --once --format iso                       # Print ISO 8601 (e.g., 2026-04-01T14:30:00+09:00)
sigye --once --format hex                       # Print hex time (e.g., 0E:1E:2D)

# TUI modes
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

Clock Mode

Pomodoro Mode

Timer Mode

Stopwatch Mode

Settings Dialog

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

Background Styles

Classic

Weather & Atmospheric

Twilight & Seasonal

System-Reactive

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

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

Copyright (c) am2rican5

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