Skip to content

WEB and GUI are good but I miss my terminal. sure a simple clock but as TUI :)

Notifications You must be signed in to change notification settings

silent-101/tickterm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TickTerm

Time, perfectly ticked — Clock • Stopwatch • Timer — All in your terminal

TickTerm Demo



▸ Features

TickTerm is your all-in-one terminal time companion, offering three powerful modes:

◆ Clock Mode

Watch time flow with a stunning retro-styled digital clock. Perfect for keeping time visible in your terminal workspace.

◆ Stopwatch Mode

Precision timing at your fingertips. Track elapsed time with millisecond accuracy for productivity sessions, workouts, or any activity that needs timing.

  • Start, stop, and resume functionality
  • Visual lap time display
  • Smooth real-time updates

◆ Timer Mode

Countdown timer with an intuitive setter interface. Set hours, minutes, and seconds with ease.

  • Interactive time setter with up/down controls
  • Pause and resume capability
  • Visual countdown display
  • Auto-reset on completion

▸ Usage

Simply run the binary:

tickterm

Requirements:

  • Minimum terminal size: 76 × 10
  • Unicode and color support recommended


▸ Key Bindings

Global Controls

Key Action
Esc Quit application
i Toggle key bindings visibility
b Back to clock mode

Mode Navigation

Key Action
w Switch to Stopwatch mode
t Switch to Timer mode

Stopwatch Controls

Key Action
Tab Cycle through buttons (Start → Stop → Reset)
Enter Activate selected button

Timer Controls

Key Action
Tab Cycle through buttons (Start → Stop → Reset) or switch value segments in setter mode
Enter Activate button or exit setter mode
Up / Down Increase/decrease selected time segment (in setter mode)


▸ Design Philosophy

TickTerm combines nostalgic pixel aesthetics with modern terminal capabilities. Each mode features:

  • Retro pixel art displays for a vintage digital clock feel
  • Smooth animations that don't compromise terminal performance
  • Intuitive controls designed for keyboard-first workflows
  • Minimal resource usage - perfect for always-on terminal sessions

▸ Supported Platforms

LinuxmacOSWindows

Cross-platform support with native binaries for all major operating systems.




Built with ♥ using Ratatui

About

WEB and GUI are good but I miss my terminal. sure a simple clock but as TUI :)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages