Skip to content

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

License

Notifications You must be signed in to change notification settings

ngnijland/MMM-text-clock

Repository files navigation

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
  • Finnish
  • French
  • Japanese
  • Italian
  • Swiss German
  • German
  • Turkish

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 xsmall | small | medium | large medium The size of the clock
language ar | ch | de | en | es | fi | fr | it | jp | nl | tr en 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
showMinutesIndicators boolean false Shows a dot at each corner of the clock for every minute past the displayed time (e.g. 18 = quarter + 3 dots). This parameter is ignored in compact mode.

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

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published