MagicMirror² v2.13.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.

  • Hi, congratulations for the job, I really needed such a module and I’m trying it on my MM but I have difficulty in viewing the times side by side, horizontally and not vertically. Can you tell me what can I do?

  • Module Developer

    I’ll refer back to the original module here:

    This code does work with my updated version of the module:

    In your custom.css:

    .worldtime {

    As a reminder, only make changes to your files, not system files.

    – B

  • Thank you very much

Log in to reply