MagicMirror² v2.12.0 is available! For more information about this release, check out this topic.


  • Module Developer

    MagicMirror Module to display clocks from multiple time zones

    After not getting an answer on Sean’s EXCEPTIONAL worldclock module (His first) from the new maintainer, I decided to fork it and start working on it myself. As such, I present to you “MMM-Worldclock”… It’s mostly Sean’s work, with a few fixes here and there right now.

    This will be fully supported, much in the spirit of Sean’s work.

    This module is derived from default MagicMirror module ‘clock’ and modified. Thanks to michaelteeuw.
    This module displays times from around the world.
    Modified fork of worldclock by eouia, renamed and improved.



    1. Execute the following commands to install the module:
    cd ~/MagicMirror/modules # navigate to module folder
    git clone # clone this repository
    1. Then, add the following into the modules section of your config/config.js file:
      module: 'MMM-Worldclock',
      position: 'top_left', // This can be any of the regions, best results in top_left or top_right regions
      config: {
        // See 'Configuration options' for more information.
        timeFormat: 'hh:mm A', //defined in moment.js format()
        style: 'top', //predefined 4 styles; 'top', 'left','right','bottom'
        offsetTimezone: null, // Or you can set `Europe/Berlin` to get timegap difference from this timezone. `null` will be UTC timegap.
        clocks: [
            title: "Home",
            title: "HOLLYWOOD", // Too long title could cause ugly text align.
            timezone: "America/Los_Angeles", //When omitted, Localtime will be displayed. It might be not your purporse, I bet.
            flag: "us",
            timezone: "Asia/Seoul",

    Of course, you should change the configuration values for your purpose.

    for configuration options see github.


    2020-08-06 (BKeyport) Fixed timeFormat per clock to work properly.
    2019-02-24 (Sean) offsetTimezone is added.
    2017-08-25 (sean) supports MMM-TelegramBot ( command /worldclock is added
    2017-08-10 (sean) Country flags are supported. HTML/CSS Structures are refined.

    ** Note: telegram bot may not work in this version, I did not modify that code in the slightest, however, if it’s relying on the module name, it’s broken. I’ll fix it if it gets reported to me.

    Thanks to Seongnoh Sean Yi’s (eouia) for his exceptional module and all the wonderful support he’s done over the years. I wouldn’t have the knowledge I have without Sean’s help.

Log in to reply