/MMM-text-clock

This MagicMirror module is a clock which shows the time as text.

Primary LanguageJavaScriptMIT LicenseMIT

MMM-text-clock

This MagicMirror module is a clock which shows the time as text.

Screenshot of module

Compact mode:

Screenshot of module in compact mode

Installation

  1. Go to the MagicMirror modules folder
cd ~/MagicMirror/modules
  1. Clone this repository
git clone https://github.com/ngnijland/MMM-text-clock.git
  1. Add this module to the modules array in the MagicMirror config/config.js file, like this:
modules: [
  {
    module: "MMM-text-clock",
    position: "middle_center"
  }
]

Language

The text clock will match it's language to MagicMirror's language config (documentation here). When the configured language is not supported the module will fall back to English. When the using the language option, the config language is ignored.

Supported languages:

  • English
  • Spanish
  • Dutch
  • French
  • Japanese
  • Italian
  • Swiss German

Configuration

Configure this module in your MagicMirror config file which is located at config/config.js in the MagicMirror repository. An example config for this module:

modules: [
  {
    module: "MMM-text-clock",
    position: "middle_center",
    config: {
      // Options
    }
  }
]

The following configurations are available:

Config Type Default value Description
compact boolean false Compact mode only shows highlighted letters
size small | medium | large medium The size of the clock
language string | string[] A language or list of languages to alternate through. Overrides config language.
languageAlternationInterval number 60 Interval in minutes at which the language changes (> 0)
fullscreen boolean false Fullscreen mode takes over your entire screen

Todo

  • Code text clock (English)
  • Add description to README
  • Add screenshots to README
  • Add configuration to README
  • Add module to third party module list of MagicMirror
  • Add contribution guide
  • Make styling work for every position available in MagicMirror software
  • Add compact mode
  • Add internationalization (add Dutch laguage)
  • Add documentation on how to contribute a new language