Magic Mirror module to show a random quote from an online collection of quotations by authors, celebrities, and newsmakers.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
images add doc Mar 17, 2018
MMM-quote-of-the-day.js code cleanup Mar 25, 2018 update readme May 19, 2018
package-lock.json add google translate Mar 14, 2018
package.json add google translate Mar 14, 2018


Module to get a random quote from various authorship.

This module is based on the Forismatic API. Quotes are only available in English but they can be translated on the fly in the language of your choice. The translation is based on the Google API. The quote is renewed following a configurable update interval.



Clone this repo into ~/MagicMirror/modules directory. Then move in the folder and install required libraries

cd MMM-quote-of-the-day
npm install

Configure your ~/MagicMirror/config/config.js:

    module: "MMM-quote-of-the-day",
    position: "lower_third",
    config: {
        language: "en",
        updateInterval: "1d"

Configuration option

Option Default Description
language en ISO-639-1 code of the language of the quote. Will be translated via google API if not set to "en"
updateInterval 1d Time between each update of the quote. Composed by an integer followed by a letter "s" or "m" or "h" or "d" for second, minute, hour or day.

Example of updateInterval:

  • 1d: update the quote every day
  • 4h: update the quote every 4 hours
  • 30m: update the quote every 30 minutes

External control

From my module by using internal notification

You can send notification to this module via your own module. by using the sendNotification method.

Update the quote from my module:

this.sendNotification("QUOTE-OF-THE-DAY", "getNewQuote")


To get a new quote from the API. Send a POST request to the /quote-of-the-day URI of your Magic Mirror

Curl example:

curl -H "Content-Type: application/json" -X POST -d '{"notification":"QUOTE-OF-THE-DAY", "payload": "getNewQuote"}' http://localhost:8080/quote-of-the-day

From Kalliope

Here is an example of usage via Kalliope assistant

  - name: "new-quote"
        - order: "give me a new quote"
        - magic_mirror:
            mm_url: ""
            notification: "QUOTE-OF-THE-DAY"
            payload: "getNewQuote"
        - say:
            message: "here is a new quote"

See an example video here.