mirror of
https://github.com/MichMich/MagicMirror.git
synced 2025-06-27 11:50:00 +00:00
Add module documentation.
This commit is contained in:
Michael Teeuw
parent
5237cf9eb1
commit
671338425a
@ -26,11 +26,11 @@ Things that still have to be implemented or changed.
|
|||||||
### Default modules:
|
### Default modules:
|
||||||
- [**Clock**](modules/clock)
|
- [**Clock**](modules/clock)
|
||||||
- [**Calendar**](modules/calendar)
|
- [**Calendar**](modules/calendar)
|
||||||
- **Current Weather**
|
- [**Current Weather**](modules/currentweather)
|
||||||
- **Weather Forecast**
|
- [**Weather Forecast**](modules/weatherforecast)
|
||||||
- **News Feed**
|
- [**News Feed**](modules/newsfeed)
|
||||||
- [**Compliments**](modules/compliments)
|
- [**Compliments**](modules/compliments)
|
||||||
- **Hello World**
|
- [**Hello World**](modules/helloworld)
|
||||||
|
|
||||||
### 3rd Party Modules:
|
### 3rd Party Modules:
|
||||||
|
|
||||||
|
|||||||
@ -33,9 +33,9 @@ The following properties can be configured:
|
|||||||
<tbody>
|
<tbody>
|
||||||
<tr>
|
<tr>
|
||||||
<td><code>timeFormat</code></td>
|
<td><code>timeFormat</code></td>
|
||||||
<td>Use 12 of 24 hour format.<br>
|
<td>Use 12 or 24 hour format.<br>
|
||||||
<br><b>Possible values:</b> <code>12</code> or <code>24</code>
|
<br><b>Possible values:</b> <code>12</code> or <code>24</code>
|
||||||
<br><b>Default value:</b> <code>24</code>
|
<br><b>Default value:</b> uses value of <i>config.timeFormat</i>
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
|
|||||||
145
modules/currentweather/README.md
Normal file
145
modules/currentweather/README.md
Normal file
@ -0,0 +1,145 @@
|
|||||||
|
# Module: Current Weather
|
||||||
|
The `currentweather` module is one of the default modules of the MagicMirror.
|
||||||
|
This module displays the current weather, including the windspeed, the sunset or sunrise time, the temperature and an icon to display the current conditions.
|
||||||
|
|
||||||
|
## Using the module
|
||||||
|
|
||||||
|
To use this module, add it to the modules array in the `config/config.js` file:
|
||||||
|
````javascript
|
||||||
|
modules: [
|
||||||
|
{
|
||||||
|
module: 'currentweather',
|
||||||
|
position: 'top_right', // This can be any of the regions.
|
||||||
|
// Best results in left or right regions.
|
||||||
|
config: {
|
||||||
|
// See 'Configuration options' for more information.
|
||||||
|
location: 'Amsterdam,Netherlands',
|
||||||
|
appid: 'abcde12345abcde12345abcde12345ab' //openweathermap.org API key.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
````
|
||||||
|
|
||||||
|
## Configuration options
|
||||||
|
|
||||||
|
The following properties can be configured:
|
||||||
|
|
||||||
|
|
||||||
|
<table width="100%">
|
||||||
|
<!-- why, markdown... -->
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Option</th>
|
||||||
|
<th width="100%">Description</th>
|
||||||
|
</tr>
|
||||||
|
<thead>
|
||||||
|
<tbody>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>location</code></td>
|
||||||
|
<td>The location used for weather information.<br>
|
||||||
|
<br><b>Example:</b> <code>Amsterdam,Netherlands</code>
|
||||||
|
<br><b>Default value:</b> <code>New York</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>appid</code></td>
|
||||||
|
<td>The <a href="https://home.openweathermap.org" target="_blank">OpenWeatherMap</a> API key, which can be obtained by creating an OpenWeatherMap account.<br>
|
||||||
|
<br> This value is <b>REQUIRED</b>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>units</code></td>
|
||||||
|
<td>What units to use?<br>
|
||||||
|
<br><b>Possible values:</b> <code>default</code> = Kelvin, <code>metric</code> = Celsius, <code>imperial</code> =Fahrenheit
|
||||||
|
<br><b>Default value:</b> <code>metric</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>updateInterval</code></td>
|
||||||
|
<td>How often does the content needs to be fetched? (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>86400000</code>
|
||||||
|
<br><b>Default value:</b> <code>300000</code> (10 minutes)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>animationSpeed</code></td>
|
||||||
|
<td>Speed of the update animation. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b><code>0</code> - <code>5000</code>
|
||||||
|
<br><b>Default value:</b> <code>2000</code> (2 seconds)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>timeFormat</code></td>
|
||||||
|
<td>Use 12 or 24 hour format.<br>
|
||||||
|
<br><b>Possible values:</b> <code>12</code> or <code>24</code>
|
||||||
|
<br><b>Default value:</b> uses value of <i>config.timeFormat</i>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>lang</code></td>
|
||||||
|
<td>The language of the days.<br>
|
||||||
|
<br><b>Possible values:</b> <code>en</code>, <code>nl</code>, <code>ru</code>, etc ...
|
||||||
|
<br><b>Default value:</b> uses value of <i>config.language</i>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>initialLoadDelay</code></td>
|
||||||
|
<td>The initial delay before loading. If you have multiple modules that use the same API key, you might want to delay one of the requests. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>5000</code>
|
||||||
|
<br><b>Default value:</b> <code>0</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>retryDelay</code></td>
|
||||||
|
<td>The delay before retrying after a request failure. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>60000</code>
|
||||||
|
<br><b>Default value:</b> <code>2500</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>apiVersion</code></td>
|
||||||
|
<td>The OpenWeatherMap API version to use.<br>
|
||||||
|
<br><b>Default value:</b> <code>2.5</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>apiBase</code></td>
|
||||||
|
<td>The OpenWeatherMap base URL.<br>
|
||||||
|
<br><b>Default value:</b> <code>'http://api.openweathermap.org/data/'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>weatherEndpoint</code></td>
|
||||||
|
<td>The OpenWeatherMap API endPoint.<br>
|
||||||
|
<br><b>Default value:</b> <code>'weather'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>iconTable</code></td>
|
||||||
|
<td>The conversion table to convert the weather conditions to weather-icons.<br>
|
||||||
|
<br><b>Default value:</b> <code>iconTable: {
|
||||||
|
'01d':'wi-day-sunny',
|
||||||
|
'02d':'wi-day-cloudy',
|
||||||
|
'03d':'wi-cloudy',
|
||||||
|
'04d':'wi-cloudy-windy',
|
||||||
|
'09d':'wi-showers',
|
||||||
|
'10d':'wi-rain',
|
||||||
|
'11d':'wi-thunderstorm',
|
||||||
|
'13d':'wi-snow',
|
||||||
|
'50d':'wi-fog',
|
||||||
|
'01n':'wi-night-clear',
|
||||||
|
'02n':'wi-night-cloudy',
|
||||||
|
'03n':'wi-night-cloudy',
|
||||||
|
'04n':'wi-night-cloudy',
|
||||||
|
'09n':'wi-night-showers',
|
||||||
|
'10n':'wi-night-rain',
|
||||||
|
'11n':'wi-night-thunderstorm',
|
||||||
|
'13n':'wi-night-snow',
|
||||||
|
'50n':'wi-night-alt-cloudy-windy'
|
||||||
|
}</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
51
modules/helloworld/README.md
Normal file
51
modules/helloworld/README.md
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
# Module: Hello World
|
||||||
|
The `helloworld` module is one of the default modules of the MagicMirror. It is a simple way to display a static text on the mirror.
|
||||||
|
## Using the module
|
||||||
|
|
||||||
|
To use this module, add it to the modules array in the `config/config.js` file:
|
||||||
|
````javascript
|
||||||
|
modules: [
|
||||||
|
{
|
||||||
|
module: 'helloworld',
|
||||||
|
position: 'bottom_bar', // This can be any of the regions.
|
||||||
|
config: {
|
||||||
|
// See 'Configuration options' for more information.
|
||||||
|
text: 'Hello world!',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
````
|
||||||
|
|
||||||
|
## Configuration options
|
||||||
|
|
||||||
|
The following properties can be configured:
|
||||||
|
|
||||||
|
|
||||||
|
<table width="100%">
|
||||||
|
<!-- why, markdown... -->
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Option</th>
|
||||||
|
<th width="100%">Description</th>
|
||||||
|
</tr>
|
||||||
|
<thead>
|
||||||
|
<tbody>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>text</code></td>
|
||||||
|
<td>The text to display.<br>
|
||||||
|
<br><b>Example:</b> <code>'Hello world!'</code>
|
||||||
|
<br><b>Default value:</b> <code>'Hello world!'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>classes</code></td>
|
||||||
|
<td>Classes to apply to the text.<br>
|
||||||
|
<br><b>Example:</b> <code>'xsmall bold'</code>
|
||||||
|
<br><b>Default value:</b> <code>'normal medium'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
76
modules/newsfeed/README.md
Normal file
76
modules/newsfeed/README.md
Normal file
@ -0,0 +1,76 @@
|
|||||||
|
# Module: News Feed
|
||||||
|
The `newsfeed ` module is one of the default modules of the MagicMirror.
|
||||||
|
This module displays news headlines based on an RSS feed.
|
||||||
|
|
||||||
|
## Using the module
|
||||||
|
|
||||||
|
To use this module, add it to the modules array in the `config/config.js` file:
|
||||||
|
````javascript
|
||||||
|
modules: [
|
||||||
|
{
|
||||||
|
module: 'newsfeed',
|
||||||
|
position: 'bottom_bar', // This can be any of the regions. Best results in center 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:
|
||||||
|
|
||||||
|
|
||||||
|
<table width="100%">
|
||||||
|
<!-- why, markdown... -->
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Option</th>
|
||||||
|
<th width="100%">Description</th>
|
||||||
|
</tr>
|
||||||
|
<thead>
|
||||||
|
<tbody>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>feedUrl</code></td>
|
||||||
|
<td>The url of the feed used for the headlines.<br>
|
||||||
|
<br><b>Default value:</b> <code>'http://www.nytimes.com/services/xml/rss/nyt/HomePage.xml'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>showPublishDate</code></td>
|
||||||
|
<td>Display the publish date of an headline.<br>
|
||||||
|
<br><b>Default value:</b> <code>true</code>
|
||||||
|
<br><b>Default value:</b> <code>true</code> or <code>false</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>reloadInterval</code></td>
|
||||||
|
<td>How often does the content needs to be fetched? (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>86400000</code>
|
||||||
|
<br><b>Default value:</b> <code>300000</code> (5 minutes)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>updateInterval</code></td>
|
||||||
|
<td>How often do you want to display a new headline? (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b><code>1000</code> - <code>60000</code>
|
||||||
|
<br><b>Default value:</b> <code>7500</code> (7.5 seconds)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>animationSpeed</code></td>
|
||||||
|
<td>Speed of the update animation. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b><code>0</code> - <code>5000</code>
|
||||||
|
<br><b>Default value:</b> <code>2000</code> (2.5 seconds)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
|
||||||
153
modules/weatherforecast/README.md
Normal file
153
modules/weatherforecast/README.md
Normal file
@ -0,0 +1,153 @@
|
|||||||
|
# Module: Weather Forecast
|
||||||
|
The `weatherforecast` module is one of the default modules of the MagicMirror.
|
||||||
|
This module displays the weather forecast for the coming week, including an an icon to display the current conditions, the minimum temperature and the maximum temperature.
|
||||||
|
|
||||||
|
## Using the module
|
||||||
|
|
||||||
|
To use this module, add it to the modules array in the `config/config.js` file:
|
||||||
|
````javascript
|
||||||
|
modules: [
|
||||||
|
{
|
||||||
|
module: 'weatherforecast',
|
||||||
|
position: 'top_right', // This can be any of the regions.
|
||||||
|
// Best results in left or right regions.
|
||||||
|
config: {
|
||||||
|
// See 'Configuration options' for more information.
|
||||||
|
location: 'Amsterdam,Netherlands',
|
||||||
|
appid: 'abcde12345abcde12345abcde12345ab' //openweathermap.org API key.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
````
|
||||||
|
|
||||||
|
## Configuration options
|
||||||
|
|
||||||
|
The following properties can be configured:
|
||||||
|
|
||||||
|
|
||||||
|
<table width="100%">
|
||||||
|
<!-- why, markdown... -->
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Option</th>
|
||||||
|
<th width="100%">Description</th>
|
||||||
|
</tr>
|
||||||
|
<thead>
|
||||||
|
<tbody>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>location</code></td>
|
||||||
|
<td>The location used for weather information.<br>
|
||||||
|
<br><b>Example:</b> <code>Amsterdam,Netherlands</code>
|
||||||
|
<br><b>Default value:</b> <code>New York</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>appid</code></td>
|
||||||
|
<td>The <a href="https://home.openweathermap.org" target="_blank">OpenWeatherMap</a> API key, which can be obtained by creating an OpenWeatherMap account.<br>
|
||||||
|
<br> This value is <b>REQUIRED</b>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>units</code></td>
|
||||||
|
<td>What units to use?<br>
|
||||||
|
<br><b>Possible values:</b> <code>default</code> = Kelvin, <code>metric</code> = Celsius, <code>imperial</code> =Fahrenheit
|
||||||
|
<br><b>Default value:</b> <code>metric</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>updateInterval</code></td>
|
||||||
|
<td>How often does the content needs to be fetched? (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>86400000</code>
|
||||||
|
<br><b>Default value:</b> <code>300000</code> (10 minutes)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>animationSpeed</code></td>
|
||||||
|
<td>Speed of the update animation. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b><code>0</code> - <code>5000</code>
|
||||||
|
<br><b>Default value:</b> <code>2000</code> (2 seconds)
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td><code>lang</code></td>
|
||||||
|
<td>The language of the days.<br>
|
||||||
|
<br><b>Possible values:</b> <code>en</code>, <code>nl</code>, <code>ru</code>, etc ...
|
||||||
|
<br><b>Default value:</b> uses value of <i>config.language</i>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>fade</code></td>
|
||||||
|
<td>Fade the future events to black. (Gradient)<br>
|
||||||
|
<br><b>Possible values:</b> <code>true</code> or <code>false</code>
|
||||||
|
<br><b>Default value:</b> <code>true</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>fadePoint</code></td>
|
||||||
|
<td>Where to start fade?<br>
|
||||||
|
<br><b>Possible values:</b> <code>0</code> (top of the list) - <code>1</code> (bottom of list)
|
||||||
|
<br><b>Default value:</b> <code>0.25</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>initialLoadDelay</code></td>
|
||||||
|
<td>The initial delay before loading. If you have multiple modules that use the same API key, you might want to delay one of the requests. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>5000</code>
|
||||||
|
<br><b>Default value:</b> <code>0</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>retryDelay</code></td>
|
||||||
|
<td>The delay before retrying after a request failure. (Milliseconds)<br>
|
||||||
|
<br><b>Possible values:</b> <code>1000</code> - <code>60000</code>
|
||||||
|
<br><b>Default value:</b> <code>2500</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>apiVersion</code></td>
|
||||||
|
<td>The OpenWeatherMap API version to use.<br>
|
||||||
|
<br><b>Default value:</b> <code>2.5</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>apiBase</code></td>
|
||||||
|
<td>The OpenWeatherMap base URL.<br>
|
||||||
|
<br><b>Default value:</b> <code>'http://api.openweathermap.org/data/'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>weatherEndpoint</code></td>
|
||||||
|
<td>The OpenWeatherMap API endPoint.<br>
|
||||||
|
<br><b>Default value:</b> <code>'forecast/daily'</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><code>iconTable</code></td>
|
||||||
|
<td>The conversion table to convert the weather conditions to weather-icons.<br>
|
||||||
|
<br><b>Default value:</b> <code>iconTable: {
|
||||||
|
'01d':'wi-day-sunny',
|
||||||
|
'02d':'wi-day-cloudy',
|
||||||
|
'03d':'wi-cloudy',
|
||||||
|
'04d':'wi-cloudy-windy',
|
||||||
|
'09d':'wi-showers',
|
||||||
|
'10d':'wi-rain',
|
||||||
|
'11d':'wi-thunderstorm',
|
||||||
|
'13d':'wi-snow',
|
||||||
|
'50d':'wi-fog',
|
||||||
|
'01n':'wi-night-clear',
|
||||||
|
'02n':'wi-night-cloudy',
|
||||||
|
'03n':'wi-night-cloudy',
|
||||||
|
'04n':'wi-night-cloudy',
|
||||||
|
'09n':'wi-night-showers',
|
||||||
|
'10n':'wi-night-rain',
|
||||||
|
'11n':'wi-night-thunderstorm',
|
||||||
|
'13n':'wi-night-snow',
|
||||||
|
'50n':'wi-night-alt-cloudy-windy'
|
||||||
|
}</code>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
Loading…
x
Reference in New Issue
Block a user