Lichess Puzzle Timer Autor: eltecson.dev

🚀 Lichess Puzzle Timer – Time-Constrained Training for Lichess Puzzles

(also available on Android)
(also available in the Chrome Web Store)

Lichess Puzzle Timer is a lightweight extension designed to help chess players train faster, smarter, and more consistently on Lichess puzzles in any device.
Built directly into the Lichess puzzle page, this extension adds a real-time puzzle timer, automated puzzle flow, and performance analytics—no external tools, no accounts, no clutter.
Perfect for players focused on speed chess, tactics training, blitz improvement, and puzzle-solving rhythm.

⏱️ Key Features

• Real-Time Puzzle Timer
  Track how long you take on every puzzle with a clean, floating timer popup that you can drag and resize.
• Any motif, any difficulty, adjustable time
  Will work in any motif, any difficulty (Lichess has built-in selection for difficulty), adjustable time. Basically as long as it has a puzzle board, it will work.
• Automatic Puzzle Detection & Skipping
  Instantly detects puzzle completion and out-of-time scenario and smoothly advances to the next puzzle.
• Settings Page
  Easily customize everything through the chrome extension's settings page (accessible through clicking the Timer Popup's Settings Button, Menu Popup's wide logo, and the extension's default_popup's wide logo).
• Timer Presets for different Time Controls:
  Very Fast – 10s time control / 3s cooldown (Ideal for Bullet)
  Fast – 20s / 3s (Ideal for Blitz)
  Normal – 60s / 3s (Ideal for Blitz and Rapid)
  Slow – 2m / 5s (ideal for Rapid)
  Very Slow – 5m / 15s (Ideal for Rapid and Classical)
• Analytics Popup
  Check your total puzzles, accuracy, total solved and unsolved puzzles in real-time.
• Customizable Visuals & Sounds
  Toggle timer visuals
  Adjustable volume
  Optional sound effects
  Light Mode preset available
• Smart, Safe Integration
• Uses safe DOM interaction
• Only runs on Lichess puzzle pages
• No tracking, no accounts, no unnecessary permissions

🧠 Designed for Serious Training

Lichess Puzzle Timer helps you:

• Improve tactical speed
• Improve time discipline
• Build puzzle-solving discipline
• Develop a consistent training rhythm
• Practice under realistic time pressure

Ideal for blitz players, bullet grinders, and tactical trainers who want a focused puzzle workflow.

🆕 Latest Updates

v3.2.0

• Added support for mobile devices
• Made the extension Firefox-compatible
• Made cancel button also cancel skipping
• Made skipToNextPuzzle=false and timerType=1 work normally
• Fix timerEnd issues

v3.0.0

• Add Enable Timer switch
• Add skip indicator (“Skipping in 5…”)
• Add toggles for sounds and visuals
• Add Timer Presets
• Add scalability to Timer and Analytics popups
• Add version indicator
• Add volume adjustment
• Auto-close extension pages opened from popups
• Add Reset Data button to Analytics popup
• Add Reset everything to defaults in settings
• Add Light Mode preset
• Fix analytics data auto-reset
• Fix analytics resetting during inactivity
• Fix icons not being customized
• Fix small popup logo not changing colors
• Only show puzzle timer on puzzle pages

v2.1.0

• Add toggle in settings for button sounds
• Improve Analytics popup UI
• Fix timer not counting solved puzzles when sound is off

v2.0.0

• Add visual change when puzzle is solved (toggleable)
• Add Analytics popup (toggleable)
• Fix chrome.storage issues with older versions
• Stop auto-starting timer when a puzzle is solved
• Fix sound issues
• Stop ticking animation when timer reaches zero
• Fix visual edge cases

v1.0.5

• Remove misleading browsing-history permission
• Add low-time visual warning (toggleable)

🔒 Privacy-Friendly & Lightweight

• No ads
• No tracking
• No external accounts
• Minimal permissions

📦 Open Source

Source code available on GitHub:
👉 https://github.com/el-tecson/lichess-puzzle-timer/