MagicMirror Module to display a calendar with multiple months

A mini-calendar with as many months as the user wants, assuming screen space is available.

Download

https://www.github.com/BKeyport/MMM-Multimonth
[card:BKeyport/MMM-Multimonth]

Installation

Clone this repository in your ~/MagicMirror/modules/ folder ( $ cd ~MagicMirror/modules/ ):

git clone https://github.com/BKeyport/MMM-Multimonth.git

Using the module

To use this module, add it to the modules array in the config/config.js file:

{
  module: 'MMM-Multimonth',
	position: 'top_left', // can be any of the postions
	config: { // Optional - will default to 3 months, with one previous and one next. 
	  startMonth: -1, // Define when you start from current month (negative is before current, zero is current, positive is in future) 
         monthCount: 3, //  How many months to display 
         highlightWeekend: false // highlightWeekend if desired, set to true. 
	}
}

Many thanks to kirash for the inspiration with the monthly_calendar module, sdetweil and lavolp3 for the help in coding and CSS work. Without your help, this would just be a pipe dream.

This is a basic module, but I felt it was good enough for release to the public.

Please, if you have any suggestions for improvement, let me know, I’m learning Javascript and CSS as I write this, and I dream of much bigger things.

~~Localization is provided by moment.js and controlled by the master language of MagicMirror. Please file any errors with localizations as bugs with the moment.js team - https://github.com/moment/moment/~~

Please see github for version info and further instructions.

@tippon To speed reinstall - I have my config.js and custom.css symlinked to a common location outside the MagicMirror tree, and a bash script setup to clone and npm install every module I use, and reinstall the symlinks.

easy peasy…

My system backs that up nightly to a private github repository, and bam quick and dirty way to get my system back running when my pi crashes.

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.

Installation

1. Execute the following commands to install the module:

cd ~/MagicMirror/modules # navigate to module folder
git clone https://github.com/BKeyport/MMM-Worldclock # clone this repository

2. 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.

Updates:

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 (https://github.com/eouia/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.

sudo Raspi-config 

Advanced Options -> GL Drivers -> Legacy.

“legacy” and “normal” drivers are the same thing.

The problem with having the mirror and the sensor so close is that the heat from the monitor and the pi itself will mess with the readings of the sensor.

@MMRIZE I’d love to see a plugin store and/or marketplace of sorts. Some other projects uses NPM with a fancy front end web to do so, much like some modules use(d) a web interface to set up the initial config or adjust configs (Sam’s config module, MMM-RTSP, etc)

This would be an ideal marketplace (Simple, to the point, shows everything a user needs) :

Then when the user wants to config:

Homebridge is one of the better ways of doing things, IMO.

https://www.youtube.com/watch?v=RFsIWtmc-WA

Becky Stern walks us through her Magic Mirror design build, including disassembling a monitor, building a frame, etc. It’s a cool setup.

One of the best commands to know is

 npm run config:check

Start at the topmost error and work your way down the file - it’s got lots of problems, but is easily fixed. Also, I highly recommend a graphical type editor if possible - Geany is what I use.

I installed samba on my magic mirror so I can edit with the PC version of Geany and save it right to the Pi. It’s great.

@danybony Monitors without any on/off logos is gonna be a tough one - You’ll want to use HDMI sleep to power up and down the monitor or simply blank it (I’d go for the latter if you’re concerned about a “No Signal” image).

As for the others - you’ll have to experiment - sadly.

General advice:

Get a monitor with a bezel on all sides - why? No lopsided display when you pull it out of frame.

Get a monitor with the cables pointing out one side or the bottom. Why? Pointing out the back will cause issues in install and make it harder to make it compact.

Get a monitor with a built in power converter (110v/220v direct into monitor) - why? For compactness reasons - less work to build frame behind it.

@mykle1 Yeah, I was looking for my modules too. :)

… and following those recommendations allows you to learn better code and improve!

@Klinge You either have some logs that have exploded in size, or a corrupting SD card. Either way, I’d recommend a reformat and/or a new SD card.

In any case, resetting the origin URL fixed it, so we have that in our toolbelt.

@sdetweil

I must have manually installed MM originally, rather than using your scripts - cloning it via SSH rather than HTTPS.

@sdetweil I think I had an error with my SSH keys and had to reset them. It’s cascading through my system. Basically, some idiot forgot he already had SSH on his system and set it up for another project. LOL

$ git remote set-url  origin https://github.com/MagicMirrorOrg/MagicMirror.git
$ git remote set-url --push  origin https://github.com/MagicMirrorOrg/MagicMirror.git

For reference if seen again.

It has to do with SSH. I’m failing out on SSH, but if I force it over to HTTPS it worked.

@sdetweil said in Magic Mirror Scripts - "Unable to determine upstream":

cd ~/MagicMirror
git branch
git remote -v

bkey1970@mirrorserv:~ $ cd ~/MagicMirror
git branch
git remote -v
  _fix_clipping
* master
origin  git@github.com:MagicMirrorOrg/MagicMirror.git (fetch)
origin  git@github.com:MagicMirrorOrg/MagicMirror.git (push)

bkey1970@mirrorserv:~ $ bash -c  "$(curl -sL https://raw.githubusercontent.com/sdetweil/MagicMirror_scripts/master/upgrade-script.sh)" apply
update log will be in /home/bkey1970/MagicMirror/installers/upgrade.log
doing test run = false
Node currently installed. Checking version number.
Minimum Node version: v22.21.1
Installed Node version: v22.18.0
installing correct version of node and npm, please wait
Check current Node installation ...
Node currently installed. Checking version number.
Minimum Node version: v22.21.1
Installed Node version: v22.21.1
No Node.js upgrade necessary.
Check current NPM installation ...
NPM currently installed. Checking version number.
Minimum npm version: V10.9.4
Installed npm version: V10.9.4
No npm upgrade necessary.

want /var/swap=512MByte, checking existing: keeping it
saving custom.css
Unable to determine upstream git repository

Upgrade started - Fri Jan  2 13:41:18 PST 2026
system is Linux mirrorserv 6.12.47+rpt-rpi-2712 #1 SMP PREEMPT Debian 1:6.12.47-1+rpt1~bookworm (2025-09-16) aarch64 GNU/Linux
user requested to apply changes
doing test run = false
the os is PRETTY_NAME="Debian GNU/Linux 12 (bookworm)" NAME="Debian GNU/Linux" VERSION_ID="12" VERSION="12 (bookworm)" VERSION_CODENAME=bookworm ID=deb>
architecture from dpkg is
^[[0mNode currently installed. Checking version number.^[[0m
^[[0mMinimum Node version: ^[[1mv22.21.1^[[0m
^[[0mInstalled Node version: ^[[1mv22.18.0^[[0m
^[[96minstalling correct version of node and npm, please wait^[[0m
  installing : node-v22.21.1
       mkdir : /usr/local/n/versions/node/22.21.1
       fetch : https://nodejs.org/dist/v22.21.1/node-v22.21.1-linux-arm64.tar.xz
     copying : node/22.21.1
   installed : v22.21.1 (with npm 10.9.4)
^[[0mNo npm engines section specified in package.json, using default=V10.9.4 ...^[[0m
^[[96mCheck current Node installation ...^[[0m
^[[0mNode currently installed. Checking version number.
^[[0mMinimum Node version: ^[[1mv22.21.1^[[0m
^[[0mInstalled Node version: ^[[1mv22.21.1^[[0m
^[[92mNo Node.js upgrade necessary.^[[0m
^[[96mCheck current NPM installation ...^[[0m
^[[0mNPM currently installed. Checking version number.
^[[0mMinimum npm version: ^[[1mV10.9.4^[[0m
^[[0mInstalled npm version: ^[[1mV10.9.4^[[0m
^[[92mNo npm upgrade necessary.^[[0m

increasing swap space
increasing swap space
saving custom.css
Unable to determine upstream git repository
Upgrade ended - Fri Jan  2 13:41:45 PST 2026

What’s going on?

what’s with the microupdates? I’ve updated three times today. 🤣