MMM-KitchenTimer - Touch-friendly countdown timer

bwente

Description:

A newly refreshed fork of MMM-KitchenTimer, a responsive, touch-friendly countdown timer for MagicMirror².

It provides a large countdown display, configurable quick-duration presets, and accessible controls for touch, mouse, and keyboard. Tap the time display to pause or resume the countdown, and use the Reset or Dismiss control to cancel the timer or silence its alarm.

The module supports compact and full-screen layouts, optional alarm and button sounds, and reliable wall-clock timing. Active timers continue running and can finish while the module is hidden by page-management modules such as MMM-pages.

MMM-KitchenTimer also provides incoming and outgoing MagicMirror notifications. Other modules can start, add time to, pause, resume, reset, or dismiss the timer. Semantic state notifications make it possible to integrate voice assistants, smart lights, MQTT bridges, physical controls, notification centers, and other automations without embedding hardware-specific behavior in the timer.

This is a maintained fork of the module originally created by Tom Short, published with his permission. The original MIT attribution and existing configuration compatibility have been preserved.

Screenshots:

MMM-KitchenTimer screenshot.png

Download:

https://github.com/bwente/MMM-KitchenTimer

Installation:

cd ~/MagicMirror/modules
git clone https://github.com/bwente/MMM-KitchenTimer.git

Version 1.1.0

Added Bulgarian, Danish, German, English, Spanish, French, Hungarian, Dutch, Russian, and Thai translations
Follow MagicMirror’s global language setting automatically
Added localized controls, status messages, and accessibility labels
Preserve keyboard and touchscreen focus while the timer display updates
Added stable control identifiers for external integrations
Expanded automated test coverage

Version 1.0.1

Keep active timers and completion events running while hidden
Improve compatibility with page-management modules such as MMM-pages

Version 1.0.0

Modernized the original module as a maintained MagicMirror² module
Added large, touch-friendly controls
Added configurable quick-duration presets
Added tap-to-pause and resume behavior
Added compact and full-screen layouts
Added incoming timer-control notifications
Added outgoing semantic state and progress notifications
Preserved the original configuration options and MIT attribution

Niggich

@bwente Nice module. How can I change the size of the module. I try something at CSS but nothing works. I want to use the module at bottom_right. THX

bwente

@Niggich Thanks! For bottom_right, try enabling the module’s built-in compact layout:

{
  module: "MMM-KitchenTimer",
  position: "bottom_right",
  config: {
    compact: true,
  },
},

Niggich

@bwente That’s it. Thank you. Is there a way to change the language to german?

bwente

@Niggich Update the module and it will use you language setting in your overall config.

Niggich

@bwente thank you. I did already and it works.

Niggich

Hey @bwente I have an Idea, but I don’t know if this is possible. I have the Screen with touch in my kitchen and also an Alexa and the old Echo Wall Clock. Maybe it’s possible to start the the Alexa Timer when I hit the Timer on my Touchscreen because I don’t have speakers at my Touchscreen.

bwente

@Niggich it’s a good idea, but unfortunately it can’t directly start a normal Alexa timer.

One option is to pair your Screen with the Echo over Bluetooth. That would give you the alarm sound through the Echo, but it wouldn’t activate the timer indicator on the Echo Wall Clock.

Another possibility may be installing alexa-remote on the Mirror or use HA. The module could notify it when a timer starts, and it could then ask the Echo to set the corresponding timer. That should also activate the Wall Clock. maybe?