Skip to main content

Troubleshooting

Common Issues

  • Mirror stays black:
    • Check config.js for syntax errors (e.g., missing comma or bracket)
  • Module does not appear:
    • Check the module’s position, name, and review the browser console/log for errors
  • Git installation fails:
    • Make sure the repository URL is public and correct
  • ZIP contains wrong folder structure:
    • The ZIP must directly contain the module folder, not an extra parent directory
  • Module installed but not added to config.js:
    • Modules only appear after being added to the configuration and refreshing
  • Not refreshing after changes:
    • Always use the Refresh/Restart button after editing config.js or installing modules

Additional Tips

  • The web interface is a convenient layer on top of a standard MagicMirror² installation
  • This documentation is product-neutral and can be branded by the manufacturer