sigye 0.2.1

A beautiful terminal clock with ASCII art fonts
sigye-0.2.1 is not a library.

sigye (시계)

Crates.io License Built With Ratatui

A beautiful terminal clock with ASCII art fonts.

sigye demo

Features

  • 40 bundled FIGlet fonts - From classic Standard to stylish Star Wars
  • 17 color themes - Including rainbow, gradient, and winter effects
  • 11 background styles - Starfield, winter themes, and system-reactive visuals
  • Animated themes - Shifting, pulsing, wave, and reactive effects
  • Blinking colon - Optional colon separator animation
  • 12/24 hour format - Toggle with a single keypress
  • Live settings preview - See changes before saving
  • Persistent configuration - Settings saved automatically
  • Custom font support - Add your own FIGlet fonts

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

Keybindings

Key Action
q / Esc Quit
t Toggle 12/24 hour format
c Cycle color theme
a Cycle animation style
b Cycle background style
s Open settings dialog

Settings Dialog

Key Action
↑ / k Previous field
↓ / j Next field
← / h Previous value
→ / l Next value
Enter Save settings
Esc Cancel

Configuration

Configuration is stored at ~/.config/sigye/config.toml:

font_name = "Standard"
color_theme = "Cyan"
time_format = "TwentyFourHour"
animation_style = "None"
animation_speed = "Medium"
colon_blink = false
background_style = "None"

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

  • 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 - Red to Orange to Yellow

Winter Gradients

  • 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

Animations

Animation Styles

  • None - Static display (default)
  • Shifting - Color hue shifts over time
  • Pulsing - Brightness pulses rhythmically
  • Wave - Color wave moves across the display
  • Reactive - Responds to time changes

Animation Speeds

Slow, Medium (default), Fast

Background Styles

Basic

  • None - No background (default)
  • Starfield - Twinkling animated stars
  • Matrix Rain - Falling green characters
  • Gradient Wave - Animated color wave

Winter Themes

  • Snowfall - Animated falling snowflakes with drift
  • Frost - Frost crystals growing from screen edges
  • Aurora - Aurora Borealis waves in green/cyan/blue/purple

System-Reactive

Real-time visualizations driven by system metrics:

  • SystemPulse - CPU usage drives pulse intensity
  • ResourceWave - Memory usage drives wave amplitude
  • DataFlow - Network I/O drives particle density
  • HeatMap - Combined metrics as heat 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

License

Copyright (c) am2rican5

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