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

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 
	}
}

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/

Versioning

0.1 Initial release, English / Sunday first only
0.2 Change code to improve functionality, allow for some localization - will not move start of week yet, but will change languages with system.
0.25 Temporary fix to allow module to refresh highlighted day of week - sometime between midnight and 1am, wasn’t doing any refresh at all in new MM configuration, didn’t realize it because I rebooted my system nightly for another tool I no longer use. Will adjust later to join in the midnight madness…
0.3 Now properly refreshes at midnight.
0.9 - Start of week now moves per moment.js. Note: at this point, module is almost everything I wanted. If I don’t get any bug reports that I can control, I’m going to bump it up to 1.0 and call it good.
0.95 - Fixed code for moving start of week, formula was backwards. Suggestion was made to add to module, will be adding soon.
0.99 - Major rewrite by Volker Wegert (Danke sehr!) - Implements everything I want, and I even understand the wizard level code he wrote.
1.00 - Minor changes to code/css to standardize look.
1.10 - Added leading and trailing months when 1 month is selected per user request.

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.

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.

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.

Take a look into https://github.com/MMM-CalendarExt2/MMM-CalendarExt2

It can make your calendars dance.

Really.

@Dask Dependencies are on a case by case basis. In many cases, it’s as simple as installing it into npm, by using npm install

In some cases, however, there’s additional outside programs or such that’s not covered by the npm install method. I’ve yet to see a module that requires additional software not include an installer script to take care of that for you, generally the readme will tell you if that’s the case.

Bottom line, follow the instructions in the readme.

FWIW, in the future,

Open a terminal
Type cd MagicMirror and press Enter
Now you’re in the MagicMirror directory
Type npm run config:check and press Enter
MagicMirror will now check your config

This is the fun part of the process. Figuring out what’s best to do for YOU.

I Would:

• Get a fan “hat” for your Pi.
• Use heat sinks
• If you use the HDMI outputs, use the one closest to the power plug.
• Know your power supply is proper for the unit. (Bad power = bad experience).
• Install using @sdetweil scripts. (See: https://docs.magicmirror.builders/getting-started/installation.html#alternative-installation-methods)

I Wouldn’t:

• Follow any old guides regarding magic mirror or follow guides not on the magicmirror.builders website - They may have bad information.
• forget to specify your OS version when searching for help (major system breaking changes happen between releases, so always search for things like this “Static IP address using buster”)
• ask questions before searching for an answer (We’ve been through it all).
• be afraid to ask questions here - no question is stupid, just some are already answered.

– Good luck, may your project be successful.

I’d just run a fan through a couple of extra holes in the frame… Easy – if you get the right voltage, you could just use the pi for powering it.

@sdetweil bonus, with a bit of trickery, I’ve got that directory backing up as needed to GitHub under a private git.

What I did was to simlink my config.js and custom.css files so I could have them in one directory, and used samba so I could share that directory to windows for editing.

@steverichab I’d name the calendar. The example is thus:

{
    name: "US holiday",
    className: "holiday", // This allows you to modify it in css
    url: "http://www.calendarlabs.com/templates/ical/US-Holidays.ics",
  },

Compare to a working config:

		{
			module: "MMM-Block",
			position: "top_right",
		},
		{
			module: "MMM-CalendarExt2",
			config: {
				calendars : [
					{
						url: "[private]",
						name: "Main Calendar", // Optional, Recommended
						maxItems: 99,
						scanInterval: 1000*60*1, // every minute, Appt Book, needs this speed
						beforeDays: 0,
						afterDays: 999,
						maxIterations: 999,
						forceLocalTZ: false,
					},
					{
						url: "http://www.trumba.com/calendars/seattle-seahawks-schedule.ics",
						name: "Seahawks Calendar",
						maxItems: 100,
						scanInterval: 24*60*60*1000,
						beforeDays: 0,
						afterDays: 999,
						maxIterations: 999,
						forceLocalTZ: false,
					},
				],
				views: [
					{
						mode: "daily",
						position: "top_right",
						slotCount: 99,
						timeFormat:"h:mm A",
						hideOverflow: false,
						filterPassedEvent: true,
						name: "Daily View",
						className: "remove_empty_slot",
						calendars: ["Main Calendar","Seahawks Calendar"],
						transform: function(event) {
							if (event.title.search("Recycle") > -1) {
								event.icon = "mdi:recycle";
								event.className = "lemay";
							}
							if (event.title.search("Yard Waste") > -1) {
								event.icon = "entypo-leaf";
								event.className = "lemay";
							}
							if (event.title.search("Seahawks") > -1) {
								event.icon = "fa-solid:football-ball";
								event.className = "seahawks";
							}
							return event;
						},
					},
				],
				scenes: [
					{
						name: "DEFAULT",
					},
				],
			},
		},

@RIKKO14 There’s a couple reasons for this:

1. The module author didn’t add their module to the page. (it’s editable by anyone)
2. The module has been removed from the list by author or other person for reasons.

Basically, the list isn’t inclusive, and nobody really maintains the list against anything else. I personally use 2 different modules that aren’t even released.

Really, this forum is the best place to find out about modules.

@boybay7 “Fork” a procedure on github to make a copy of the code under your own username so you can make changes to the code without worrying about messing with the original, or breaking it if you want to back off to the original easily.

but, I understand you’re only changing the custom.css file - that’s great, best way to fix things visually!

@sdetweil There’s no iFrame for the stream. It’s painted directly to the screen, the module just launches it and cuts room out of the screen for it.

OMX Don’t care.

@boybay7 said in Changing the colour of all text on screen:

@lavolp3 So just to confirm, even though I have edited code in like modules or custom.css for the font colour, it won’t be replaced when I update with git pull?

Short answer without a bunch of confusing and unneeded parts: Yes.

Long answer in simple form but more detail:
These aren’t updated when you follow recommended upgrade path (usually just git pull && npm install in magicmirror directory):
config.js
custom.css
modules directory structure except for the default directory tree

There are scripts out there to stash any changes you have made to changed items, however, 99.99% of the time, changes are not needed to updated parts of the MagicMirror ecosystems. the remaining time, it’s a change to get around a short term bug (like currently, the calendar applet), that will be included in the next update, so there’s no reason to stash it.

Bottom line - your customizations, unless done in a poor way, will never be deleted, until you rm -rf the whole mess or the boot device (Not just SD anymore!) crashes.

If you’ve decided to customize a module within it’s own code, that isn’t a official fix of the module, I would highly recommend forking the project, switching to your fork, then modifying to your needs. Then, if you think everyone else would benefit from it, please do a merge request, and let the author(s) decide to do so, or, in the case of dead modules, change the name and take over the project (I’ve done that with MMM-Worldclock, for instance)

Alphons: that’s exactly how the various streams are designed to act. It’s not a problem of the module, it’s a problem of the stream itself. You have to stop the stream in order to make the stream go away.

@Mykle1 LOL

@Mykle1 Yeah, I got the edit report, too.