# Module: Calendar The `calendar` module is one of the default modules of the MagicMirror. This module displays events from a public .ical calendar. It can combine multiple calendars. ## Using the module To use this module, add it to the modules array in the `config/config.js` file: ````javascript modules: [ { module: 'calendar', position: 'top_left', // This can be any of the regions. Best results in left or right regions. config: { // The config property is optional. // If no config is set, an example calendar is shown. // See 'Configuration options' for more information. } } ] ```` ## Configuration options The following properties can be configured:
Option Description
maximumEntries The maximum number of events shown.

Possible values: 0 - 100
Default value: 10
displaySymbol Display a symbol in front of an entry.

Possible values: true or false
Default value: true
defaultSymbol The default symbol.

Possible values: See Font Awsome website.
Default value: calendar
maxTitleLength The maximum title length.

Possible values: 10 - 50
Default value: 25
fetchInterval How often does the content needs to be fetched? (Milliseconds)

Possible values: 1000 - 86400000
Default value: 300000 (5 minutes)
animationSpeed Speed of the update animation. (Milliseconds)

Possible values:0 - 5000
Default value: 2000 (2 seconds)
fade Fade the future events to black. (Gradient)

Possible values: true or false
Default value: true
fadePoint Where to start fade?

Possible values: 0 (top of the list) - 1 (bottom of list)
Default value: 0.25
calendars The list of calendars.

Possible values: An array, see calendar configuration below.
Default value: An example calendar.
titleReplace An object of textual replacements applied to the tile of the event. This allow to remove or replace certains words in the title.

Example:
titleReplace: {'Birthday of ' : '', 'foo':'bar'}
### Calendar configuration The `calendars` property contains an array of the configured calendars. #### Default value: ````javascript config: { calendars: [ { url: 'http://www.calendarlabs.com/templates/ical/US-Holidays.ics', symbol: 'calendar', }, ], } ```` #### Calendar configuration options:
Option Description
url The url of the calendar .ical. This property is required.

Possible values: Any public accessble .ical calendar.
symbol The symbol to show in front of an event. This property is optional.

Possible values: See Font Awsome website.