Skip to content
No description, website, or topics provided.
Branch: master
Clone or download


Type Name Latest commit message Commit time
Failed to load latest commit information.
images feat: images added Jan 11, 2020
.gitignore chore: added a git ignore Jan 9, 2020 fix: api url updated Feb 7, 2020
on-this-day.js refactor: code cleaned Feb 7, 2020

MagicMirror² Module: On-This-Day

on-this-day is a module for MagicMirror² that displays a random fact of something that happened on this day in history.


This module is based on an API that I made myself which has hundreds of facts stored for each day of the year. The facts are only available in English, the API is totally free to use and can be found at:${day}. The day must be in the format 07-10, which would represent the 10th July.

The fact displayed on your Magic Mirror will be updated everyday at midnight.


Go to your MagicMirror's Module folder in your terminal:

cd ~/MagicMirror/modules

Clone this repository:

git clone

Go to the modules folder:

cd on-this-day

Install the dependencies:

npm install

Add the module to the modules array in the config/config.js file by adding the following section. You can change this configuration later when you see this works:

    module: 'on-this-day',
    position: 'bottom_bar',
    config: {
                // see below for configurable options...

Configuration options:

Option Description
updateInterval How often the fact will be updated during the day. It is automatically updated everyday at 00:00, but if you wish for the fact to be updated more often, add your own timeframe in milliseconds (1000 = 1 second).

Example: 1000 * 60 = will be updated every minute.
Default value: undefined
animationSpeed The speed of the update animation in milliseconds.

Example:500 = half a second.
Default value: 1000 = 1 second.
interests An array of interests you may have to curate the facts you will receive.

Possible values: "history", "film-tv", "sport"
Default value: "general"

I hope you enjoy the module and learn something new everyday!

You can’t perform that action at this time.