Unbelievable! MagicMirror is voted number 1 in the MagPi Top 50.

Of all the awesome Raspberry Pi projects around the world, the Raspberry Pi community has chosen the MagicMirror project as the number one project. You guys can’t believe how extremely proud I am!

For anyone who voted: thank you very very much!

Dear MagicMirror Community,

As we step into 2024, MagicMirror marks a significant milestone - a decade of innovation, collaboration, and growth. Ten years ago, I embarked on an incredible journey with the inception of the MagicMirror project on GitHub. It has been an honor and a privilege to witness this project evolve, driven by the passion and dedication of a vibrant and creative community.

However, life is an ever-changing tapestry, and with new priorities and paths unfolding for me, the time has come to make a pivotal decision. Recognizing that my ability to invest the energy and attention MagicMirror deserves is diminishing, I have decided that it is in the best interest of the project to transition its stewardship to those who can carry its legacy forward with renewed vigor and vision.

Today, I am announcing the transfer of the MagicMirror repository to a new GitHub organization. This move is not an end, but rather a new beginning - a step towards transforming MagicMirror into a fully community-led project. It is my firm belief that this transition will open new avenues for innovation and growth, ensuring that MagicMirror continues to thrive and adapt in the ever-evolving tech landscape.

I want to extend my heartfelt gratitude to everyone who has contributed to MagicMirror over the past decade. Your contributions, big and small, have been the lifeblood of this project, and I am deeply thankful for your support and enthusiasm.

As we move forward, I want to assure you that this transition will be smooth and thoughtful. The repository’s shift to a new organization is just the first step in this transformation. In the future, we may also transition other components of the project, such as the website, forum, and servers, to ensure that MagicMirror continues to be supported and nurtured by its community.

I am excited to see where you, the community, will take MagicMirror next. Here’s to a future filled with innovation, collaboration, and success.

Thank you for being a part of this incredible journey.

Warm regards,

Michael Teeuw

It took a while, but it’s finally here … The MagicMirror project has it’s own website: https://magicmirror.builders

If you stumble across some typo’s or know a nice addition to the website, feel free to send a pull request: https://github.com/MichMich/MagicMirror-Website

As an end of year present, I just released version V2.1.0:
https://github.com/MichMich/MagicMirror/releases/tag/v2.1.0

Special thanks to @roramirez for a LOT of awesome contributions.

[2.1.0] - 2016-12-31

Note: This update uses new dependencies. Please update using the following command: git pull && npm install

Added

• Finnish translation.
• Danish translation.
• Turkish translation.
• Option to limit access to certain IP addresses based on the value of ipWhitelist in the config.js, default is access from localhost only (Issue #456).
• Added ability to change the point of time when calendar events get relative.
• Add Splash screen on boot.
• Add option to show humidity in currentWeather module.
• Add VSCode IntelliSense support.
• Module API: Add Visibility locking to module system. See documentation for more information.
• Module API: Method to overwrite the module’s header. See documentation for more information.
• Module API: Option to define the minimum MagicMirror version to run a module. See documentation for more information.
• Calendar module now broadcasts the event list to all other modules using the notification system. See documentation for more information.
• Possibility to use the the calendar feed as the source for the weather (currentweather & weatherforecast) location data. See documentation for more information.
• Added option to show rain amount in the weatherforecast default module
• Add module updatenotification to get an update whenever a new version is availabe. See documentation for more information.
• Add the abilty to set timezone on the date display in the Clock Module
• Ability to set date format in calendar module
• Possibility to use currentweather for the compliments
• Added option disabled for modules.
• Added option address to set bind address.
• Added option onlyTemp for currentweather module to show show only current temperature and weather icon.
• Added option remoteFile to compliments module to load compliment array from filesystem.
• Added option zoom to scale the whole mirror display with a given factor.
• Added option roundTemp for currentweather and weatherforecast modules to display temperatures rounded to nearest integer.
• Added abilty set the classes option to compliments module for style and text size of compliments.
• Added ability to configure electronOptions
• Calendar module: option to hide private events
• Add root_path for global vars

Updated

• Modified translations for Frysk.
• Modified core English translations.
• Updated package.json as a result of Snyk security update.
• Improve object instantiation to prevent reference errors.
• Improve logger. Log.log() now accepts multiple arguments.
• Remove extensive logging in newsfeed node helper.
• Calendar times are now uniformly capitalized.
• Modules are now secure, and Helmet is now used to prevent abuse of the Mirror’s API.

Fixed

• Solve an issue where module margins would appear when the first module of a section was hidden.
• Solved visual display errors on chrome, if all modules in one of the right sections are hidden.
• Global and Module default config values are no longer modified when setting config values.
• Hide a region if all modules in a region are hidden. Prevention unwanted margins.
• Replaced electron-prebuilt package with electron in order to fix issues that would happen after 2017.
• Documentation of alert module

It’s that time of the year again. A fresh new version of MagicMirror is waiting for you! Thanks to everyone who contributed! You guys rock!

https://github.com/MichMich/MagicMirror/releases/tag/v2.1.2

[2.1.2] - 2017-07-01

Changed

• Revert Docker related changes in favor of docker-MagicMirror. All Docker images are outsourced. (#856)
• Change Docker base image (Debian + Node) to an arm based distro (AlpineARM + Node) (#846)
• Fix the dockerfile to have it running from the first time.

Added

• Add in option to wrap long calendar events to multiple lines using wrapEvents configuration option.
• Add test e2e show title newsfeed for newsfeed module.
• Add task to check configuration file.
• Add test check URLs of vendors.
• Add test of match current week number on clock module with showWeek configuration.
• Add test default modules present modules/default/defaultmodules.js.
• Add unit test calendar_modules function capFirst.
• Add test for check if exists the directories present in defaults modules.
• Add support for showing wind direction as an arrow instead of abbreviation in currentWeather module.
• Add support for writing translation fucntions to support flexible word order
• Add test for check if exits the directories present in defaults modules.
• Add calendar option to set a separate date format for full day events.
• Add ability for currentweather module to display indoor temperature via INDOOR_TEMPERATURE notification
• Add ability to change the path of the custom.css.
• Add translation Dutch to Alert module.
• Added Romanian translation.

Updated

• Added missing keys to Polish translation.
• Added missing key to German translation.
• Added better translation with flexible word order to Finnish translation

Fixed

• Fix instruction in README for using automatically installer script.
• Bug of duplicated compliments as described in here.
• Fix double message about port when server is starting
• Corrected Swedish translations for TODAY/TOMORROW/DAYAFTERTOMORROW.
• Removed unused import from js/electron.js
• Made calendar.js respect config.timeFormat irrespecive of locale setting
• Fixed alignment of analog clock when a large calendar is displayed in the same side bar

MagicMirror² version 2.6.0 was just released:
https://github.com/MichMich/MagicMirror/releases/tag/v2.6.0

A huge, huge, huge thanks to user @fewieden for all his hard work on the new experimental weather module!

[2.6.0] - 2019-01-01

ℹ️ Note: This update uses new dependencies. Please update using the following command: git pull && npm install. If you are having issues updating, make sure you are running the latest version of Node.

✨ Experimental ✨

• New default module weather. This module will eventually replace the current currentweather and weatherforecast modules. The new module is still pretty experimental, but it’s included so you can give it a try and help us improve this module. Please give us you feedback using this forum post.

A huge, huge, huge thanks to user @fewieden for all his hard work on the new weather module!

Added

• Possibility to add classes to the cell of symbol, title and time of the events of calendar.
• Font-awesome 5, still has 4 for backwards compatibility.
• Missing showEnd in calendar documentation
• Screenshot for the new feed module
• Screenshot for the compliments module
• Screenshot for the clock module
• Screenshot for the current weather
• Screenshot for the weather forecast module
• Portuguese translation for “Feels”
• Croatian translation
• Fading for dateheaders timeFormat in Calendar #1464
• Documentation for the existing scale option in the Weather Forecast module.

Fixed

• Allow to parse recurring calendar events where the start date is before 1900
• Fixed Polish translation for Single Update Info
• Ignore entries with unparseable details in the calendar module
• Bug showing FullDayEvents one day too long in calendar fixed
• Bug in newsfeed when removeStartTags is used on the description #1478

Updated

• The default calendar setting showEnd is changed to false.

Changed

• The Weather Forecast module by default displays the ° symbol after every numeric value to be consistent with the Current Weather module.

[2.12.0] - 2020-07-01

https://github.com/MichMich/MagicMirror/releases/tag/v2.12.0

Special thanks to the following contributors: @AndreKoepke, @andrezibaia, @bryanzzhu, @chamakura, @DarthBrento, @Ekristoffe, @khassel, @Legion2, @ndom91, @radokristof, @rejas, @XBCreepinJesus & @ZoneMR.

ℹ️ Note: This update uses new dependencies. Please update using the following command: git pull && npm install.

Added

• Added option to config the level of logging.
• Added prettier for an even cleaner codebase.
• Hide Sunrise/Sunset in Weather module.
• Hide Sunrise/Sunset in Current Weather module.
• Added Met Office DataHub (UK) provider.

Updated

• Cleaned up alert module code.
• Cleaned up check_config code.
• Replaced grunt-based linters with their non-grunt equivalents.
• Switch to most of the eslint:recommended rules and fix warnings.
• Replaced insecure links with https ones.
• Cleaned up all “no-undef” warnings from eslint.
• Added location title wrapping for calendar module.
• Updated the BG translation.

Deleted

• Removed truetype (ttf) fonts.

Fixed

• The broken modules due to Socket.io change from last release. #1973
• Add backward compatibility for old module code in socketclient.js. #1973
• Support multiple instances of calendar module with different config. #1109
• Fix the use of “maxNumberOfDays” in the module “weatherforecast”. #2018
• Throw error when check_config fails. #1928
• Bug fix related to ‘maxEntries’ not displaying Calendar events. #2050
• Updated ical library to latest version. #1926

Because the documentation was getting more extensive than I ever expected, I created a separate docs website:

https://docs.magicmirror.builders

This way the docs is are better readable and better maintainable. It also allows us to update the docs without the need of releasing a new MagicMirror release.

Head over to the new docs site and let me know what you think. I’ll continue to work on the content. Feel free to send me PR’s if you want help out.

Good to know: every page includes an edit link on the bottom which will generate a PR.

I’ve updated all MagicMirror² sites (home, forum, readme) to reflect this change. If you find a page that needs an update, please let me know.

As far as I know the largest Magic Mirror so far:

More info: http://michaelteeuw.nl/post/150349424992/mirror-mirror-on-the-wall-who-has-the-biggest-of

Because the number of modules you guys created grew FAR above what I expected when I started this project, I think it couldn’t hurt to improve the discoverability of the modules. Because of this, I’m working on a new and improved website which includes a module search …

In the future, I’ll add:

• Module suggestions based on the modules you like.
• Similar modules on a module page.
• Modules per user (“Other modules by this developer”)

If you have any suggestions, feel free to let me know, although I won’t promise anything…

It’s far beyond finished, but if you’re curious, feel free to check out the very early beta version:

http://beta.magicmirror.builders/modules

If you login with your github account, you should be able to add your modules. As a test I added some random modules.

Please note that I might need to reset the database in the future. So don’t spent too much time on adding your modules. (Although a filled database would be helpful in the development.)

MagicMirror² version 2.7.0 was just released:
https://github.com/MichMich/MagicMirror/releases/tag/v2.7.0

❤️ Donate: Enjoying MagicMirror²? Please consider a donation! With your help we can continue to improve the MagicMirror² core.

[2.7.0] - 2019-04-01

ℹ️ Note: This update uses new dependencies. Please update using the following command: git pull && npm install. If you are having issues running Electron, make sure your Raspbian is up to date.

Added

• Italian translation for “Feels”
• Basic Klingon (tlhIngan Hol) translations
• Disabled the screensaver on raspbian with installation script
• Added option to truncate the number of vertical lines a calendar item can span if wrapEvents is enabled.
• Danish translation for “Feels” and “Weeks”
• Added option to split multiple day events in calendar to separate numbered events
• Slovakian translation
• Alerts now can contain Font Awesome icons
• Notifications display time can be set in request
• Newsfeed: added support for ARTICLE_INFO_REQUEST notification
• Add name config option for calendars to be sent along with event broadcasts

Updated

• Bumped the Electron dependency to v3.0.13 to support the most recent Raspbian. #1500
• Updated modernizr code in alert module, fixed a small typo there too
• More verbose error message on console if the config is malformed
• Updated installer script to install Node.js version 10.x

Fixed

• Fixed temperature displays in currentweather and weatherforecast modules #1503, #1511.
• Fixed unhandled error on bad git data in updatenotification module #1285.
• Weather forecast now works with openweathermap in new weather module. Daily data are displayed, see issue #1504.
• Fixed analogue clock border display issue where non-black backgrounds used (previous fix for issue 611)
• Fixed compatibility issues caused when modules request different versions of Font Awesome, see issue #1522. MagicMirror now uses Font Awesome 5 with v4 shims included for backwards compatibility.
• Installation script problems with raspbian
• Calendar: only show repeating count if the event is actually repeating #1534
• Calendar: Fix exdate handling when multiple values are specified (comma separated)
• Calendar: Fix relative date handling for fulldate events, calculate difference always from start of day #1572
• Fix null dereference in moduleNeedsUpdate when the module isn’t visible
• Calendar: Fixed event end times by setting default calendarEndTime to “LT” (Local time format). [#1479]
• Calendar: Fixed missing calendar fetchers after server process restarts #1589
• Notification: fixed background color (was white text on white background)
• Use getHeader instead of data.header when creating the DOM so overwriting the function also propagates into it
• Fix documentation of useKMPHwind option in currentweather

New weather module

• Fixed weather forecast table display #1499.
• Dimmed loading indicator for weather forecast.
• Implemented config option decimalSymbol #1499.
• Aligned indoor values in current weather vertical #1499.
• Added humidity support to nunjuck unit filter.
• Do not display degree symbol for temperature in Kelvin #1503.
• Weather forecast now works with openweathermap for both, /forecast and /forecast/daily, in new weather module. If you use the /forecast-weatherEndpoint, the hourly data are converted to daily data, see issues #1504, #1513.
• Added fade, fadePoint and maxNumberOfDays properties to the forecast mode #1516
• Fixed Loading string and decimalSymbol string replace #1538
• Show Snow amounts in new weather module #1545
• Added weather.gov as a new weather provider for US locations

Unfortunaly not our MagicMirror project. :(

MagPi confirmed that they nominated the real Magic Mirror project. Please cast your vote here:

https://www.raspberrypi.org/blog/vote-top-20-raspberry-pi-projects-magpi/#comment-1262470

MagicMirror² V2.5.0 was just released.

https://github.com/MichMich/MagicMirror/releases/tag/v2.5.0

[2.5.0] - 2018-10-01

Added

• Support multi-line compliments
• Simplified Chinese translation for “Feels”
• Polish translate for “Feels”
• French translate for “Feels”
• Translations for newsfeed module
• Support for toggling news article in fullscreen
• Hungarian translation for “Feels” and “Week”
• Spanish translation for “Feels”
• Add classes instead of inline style to the message from the module Alert
• Support for events having a duration instead of an end
• Support for showing end of events through config parameters showEnd and dateEndFormat

Fixed

• Fixed gzip encoded calendar loading issue #1400.
• Mixup between german and spanish translation for newsfeed.
• Fixed close dates to be absolute, if no configured in the config.js - module Calendar
• Fixed the UpdateNotification module message about new commits in the repository, so they can be correctly localized in singular and plural form.
• Fix for weatherforecast rainfall rounding #1374
• Fix calendar parsing issue for Midori on RasperryPi Zero w, related to issue #694.
• Fix weather city ID link in sample config
• Fixed issue with clientonly not updating with IP address and port provided on command line.

Updated

• Updated Simplified Chinese translation
• Swedish translations
• Hungarian translations for the updatenotification module
• Updated Norsk bokmål translation
• Updated Norsk nynorsk translation
• Consider multi days event as full day events

If you haven’t yet, don’t forget to check out the newest issue of MagPi. It has an 11 page long coverstory of #MagcMirror:
https://www.raspberrypi.org/magpi/issues/54/

The decision was based on the (professional) experience, and the involvement in the project. Since we are still growing, keep an eye on this topic for future moderator positions.

Everyone that applied: thank you very much. Your commitment is very valuable to us and the project!

@yawns, @morozgrafix and @Jopyth, welcome to the team! 👍

[2.11.0] - 2020-04-01

https://github.com/MichMich/MagicMirror/releases/tag/v2.11.0

🚨 READ THIS BEFORE UPDATING 🚨

In the past years the project has grown a lot. This came with a huge downside: poor maintainability. If I let the project continue the way it was, it would eventually crash and burn. More important: I would completely lose the drive and interest to continue the project. Because of this the decision was made to simplify the core by removing all side features like automatic installers and support for exotic platforms. This release (2.11.0) is the first real release that will reflect (parts) of these changes. As a result of this, some things might break. So before you continue make sure to backup your installation. Your config, your modules or better yet: your full MagicMirror folder. In other words: update at your own risk.

For more information regarding this major change, please check issue #1860.

Deleted

• Remove installers.
• Remove externalized scripts.
• Remove jshint dependency, instead eslint checks your config file now

Added

• Brazilian translation for “FEELS”.
• Ukrainian translation.
• Finnish translation for “PRECIP”, “UPDATE_INFO_MULTIPLE” and “UPDATE_INFO_SINGLE”.
• Added the ability to hide the temp label and weather icon in the currentweather module to allow showing only information such as wind and sunset/rise.
• The clock module now optionally displays sun and moon data, including rise/set times, remaining daylight, and percent of moon illumination.
• Added Hebrew translation.
• Add HTTPS support and update config.js.sample
• Run tests on long term support and latest stable version of nodejs
• Added the ability to configure a list of modules that shouldn’t be update checked.
• Run linters on git commits
• Added date functionality to compliments: display birthday wishes or celebrate an anniversary

Fixed

• Force declaration of public ip address in config file (ISSUE #1852)
• Fixes run-start.sh: If running in docker-container, don’t check the environment, just start electron (ISSUE #1859)
• Fix calendar time offset for recurring events crossing Daylight Savings Time (ISSUE #1798)
• Fix regression in currentweather module causing ‘undefined’ to show up when config.hideTemp is false
• Fix FEELS translation for Croatian
• Fixed weather tests #1840
• Fixed Socket.io can’t be used with Reverse Proxy in serveronly mode #1934
• Fix update checking skipping 3rd party modules the first time

Changed

• Remove documentation from core repository and link to new dedicated docs site: docs.magicmirror.builders.
• Updated config.js.sample: Corrected some grammar on config.js.sample comment section.
• Removed run-start.sh script and update start commands:
  • To start using electron, use npm run start.
  • To start in server only mode, use npm run server.
• Remove redundant logging from modules.
• Timestamp in log output now also contains the date
• Turkish translation.
• Option to configure the size of the currentweather module.

This MagicMirror² module keeps an eye on your UI and quits app in case the UI crashes. If you combine this with the PM2 process manager, MM2 will automaticly restart after a UI failure.

[card:MichMich/MMM-WatchDog]

@wjdw87 You really didn’t read any word of this topic. Did you? 😂

5 years ago I started the MagicMirror project as a fun project for myself only. After blogging about it, the responses to the project where overwhelming. With the advent of MagicMirror², the project has grown to something I never dared to dream of.

The MagicMirror project has a huge community behind it, mainly in the form of this forum. Hosting this project not only takes up some of my time, but also a fair amount of money.

I absolutely want to keep this forum Ad free. Just as I want to keep the MagicMirror² free and opensource. More importantly: I’d like to free up some of my work hour to spent more time working on the core.

Unfortunately this isn’t possible without some additional funds. Because of this I’m considering taking on donations. In what way or form isn’t completely clear yet. And for that I’d like to hear your ideas …

What are our thoughts about taking donations to support the MagicMirror project? Would you be willing to donate? And if so, would you prefer one time donations, or recurring donations. What platforms do you prefer to send donations? And do you think this is possible without giving additional perks to supporters?

Your thought in this process are very valuable to me. Please let me know what your thoughts are and what you think is the best approach to do so.

Don’t worry: you’ll always be able to use MagicMirror even without any donations.

Thanks in advance!

Edit: I’ve added to option to donate: http://magicmirror.builders/donate

For anyone running into this issue, run the following command from your MagicMirror folder:

 npm install electron@1.4.15