Skip to content

πŸ•’β±οΈ Minimalist clock and break timer for educators, trainers, and presenters. Features analog/digital clock and fullscreen countdown timer with presets. Available as web app or cross-platform desktop app (Windows/Mac/Linux).

Notifications You must be signed in to change notification settings

timothywarner-org/tims-clock-break-timer

Repository files navigation

Tim's Clock & Break Timer πŸ•’β±οΈ

A sleek, minimalist clock and break timer designed for educators, trainers, and presenters. Features a beautiful analog/digital clock for your desktop and a fullscreen countdown timer perfect for managing class breaks.

🌐 TechTrainerTim.com

GitHub release (latest by date) GitHub Workflow Status License

✨ Features

πŸ• Personal Clock

  • Clean analog clock with smooth second hand
  • Digital time display with seconds
  • Full date with day of week
  • Minimal, distraction-free design
  • Link to timer for quick access

⏲️ Break Timer

  • Preset timers: 5, 8, 9, and 10 minutes
  • Custom timer input (1-999 minutes)
  • High-precision timing that works in background tabs
  • Motivational quotes during breaks
  • Visual pulse animation when time's up
  • Keyboard shortcuts (Space: play/pause, R: reset, 1-4: presets, F11: fullscreen)
  • Perfect for Pomodoro Technique, classroom breaks, or meeting timeouts

πŸ’» Desktop App (Electron)

  • Dual-window design: Clock + Timer
  • Resizable windows with always-on-top option
  • Cross-platform: Windows, macOS, Linux
  • Professional menu system
  • Fullscreen support for presentations

πŸš€ Quick Start

Web Version

npm install
npm start

Desktop App

Download the latest release from the Releases page or build from source:

npm install
npm run electron

πŸ› οΈ Build Desktop App

# Windows
npm run build-win

# macOS  
npm run build-mac

# Linux
npm run build-linux

# All platforms
npm run build-all

🎨 Design Philosophy

  • Minimalist: Clean interface without distractions
  • Accessible: High contrast, colorblind-friendly palette
  • Performant: GPU-accelerated animations, efficient updates
  • Reliable: Accurate timing even in background tabs

πŸ”§ Technologies

  • Vanilla JavaScript (no frameworks)
  • HTML5 Canvas for analog clock
  • CSS3 animations with GPU hints
  • Electron for desktop packaging
  • GitHub Actions for automated builds

πŸ“ License

ISC License - feel free to use in your classrooms and presentations!

🀝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.

πŸ‘¨β€πŸ« About

Created by Tim Warner for educators and presenters worldwide. Perfect for:

  • Classroom break management
  • Workshop timing
  • Presentation pacing
  • Pomodoro Technique
  • Meeting timeouts

Made with ❀️ for the teaching community

About

πŸ•’β±οΈ Minimalist clock and break timer for educators, trainers, and presenters. Features analog/digital clock and fullscreen countdown timer with presets. Available as web app or cross-platform desktop app (Windows/Mac/Linux).

Topics

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •