Skip to content
Branch: master
Find file History

README.md

Module: Alert

The alert module is one of the default modules of the MagicMirror. This module displays notifications from other modules.

Usage

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

modules: [
	{
		module: "alert",
		config: {
			// The config property is optional.
			// See 'Configuration options' for more information.
		}
	}
]

Configuration options

The following properties can be configured:

Option Description
effect The animation effect to use for notifications.

Possible values: scale slide genie jelly flip exploader bouncyflip
Default value: slide
alert_effect The animation effect to use for alerts.

Possible values: scale slide genie jelly flip exploader bouncyflip
Default value: jelly
display_time Time a notification is displayed in milliseconds.

Possible values: int
Default value: 3500
position Position where the notifications should be displayed.

Possible values: left center right
Default value: center
welcome_message Message shown at startup.

Possible values: string false
Default value: false (no message at startup)

Developer notes

For notifications use:

self.sendNotification("SHOW_ALERT", {type: "notification"});

For alerts use:

self.sendNotification("SHOW_ALERT", {});

Notification params

Option Description
title The title of the notification.

Possible values: text or html
message The message of the notification.

Possible values: text or html
timer (optional) How long the notification should stay visible in ms.
If absent, the default display_time is used.
Possible values: int float

Alert params

Option Description
title The title of the alert.

Possible values: text or html
message The message of the alert.

Possible values: text or html
imageUrl (optional) Image to show in the alert

Possible values: url path
Default value: none
imageFA (optional) Font Awesome icon to show in the alert

Possible values: See Font Awsome website.
Default value: none
imageHeight (optional even with imageUrl set) Height of the image

Possible values: intpx
Default value: 80px
timer (optional) How long the alert should stay visible in ms.
Important: If you do not use the timer, it is your duty to hide the alert by using self.sendNotification("HIDE_ALERT");!

Possible values: int float
Default value: none

Open Source Licenses

NotificationStyles

See tympanus.net for license.

You can’t perform that action at this time.