Description

The MMM-OnScreenMenu Module provides a small, customizable, material-style floating action button menu for controlling the MagicMirror².

Basic Functions:

1. Control the power to the screen (On/Off/Toggle).
2. Manage the Mirror (Shutdown/Reboot/Restart MM²/Refresh Window).
3. Module Visibility (Show/Hide/Toggle).
4. Send Notifications to Other Modules:
   • Switch Profiles in MMM-ProfileSwitcher
   • Perform other module functions from a button in the menu.

The menu is designed to be controllable from multiple devices:

• Mouse Control
• Touchscreen Control
• Keyboard Control
• Bluetooth Remote via MMM-KeyBindings
• Module Notifications from other modules

Screenshots

SEE LIVE DEMO/MOCKUP HERE: https://codepen.io/shbatm/pen/OggMbr/

First: Touch Mode; Middle: Hidden/Mouseover Mode; Last: Demo

Download:

[card:shbatm/MMM-OnScreenMenu]

---

Version 0.1.3

• Added menu options for minimizing, toggle fullscreen mode, opening DevTools, stopping MM via PM2,
• Added delayed menu items (e.g. call a function after a certain timeout–like to turn off the mirror after X seconds)
• Added external control of the menu/functions from other modules via notifications–includes the ability to call any function the module knows how to handle, even if it’s not in the menu. This lets you use modules like MMM-Buttons or MMM-MPR121 to control the menu.

Version 0.0.9

• Initial Public Release for Testing – please let me know via this thread or GitHub Issues if you find any bugs or have any feature requests; always open to feedback!

Description:

This is a simple module which extends the Node.js console logging capabilities of the MagicMirror² project through implementation of the tracer Node.js module, including adding timestamps, call sources, and stack traces.

By default, this module will intercept and format ALL console log messages from the MagicMirror instance once it is loaded so no additional changes need to be made to individual modules. If they log output using the standard console.log() or console.error() they will be reformatted and pretty printed.

Examples:

Before MMM-Logging:

0|mm  | Starting MagicMirror: v2.6.0-dev
0|mm  | Loading config ...
0|mm  | Loading module helpers ...
0|mm  | Initializing new module helper ...
0|mm  | Module helper loaded: MMM-Logging
0|mm  | No helper found for module: alert.

After MMM-Logging:

0|mm  | Starting MagicMirror: v2.6.0-dev
0|mm  | Loading config ...
0|mm  | Loading module helpers ...
0|mm  | 2018-12-05T12:42:51 <log> Initializing new module helper ... (js/app.js:128 loadModule)
0|mm  | 2018-12-05T12:42:51 <log> Module helper loaded: MMM-Logging (js/app.js:161 loadNextModule)
0|mm  | 2018-12-05T12:42:51 <log> No helper found for module: alert. (js/app.js:163 )

Download:

[card:shbatm/MMM-Logging]

---

Current Version: 1.0.1 – CHANGELOG

Description

This module will show a live RTSP video stream and/or periodic snapshots on the Magic Mirror from any IP Security Camera which supports the RTSP protocol and/or can serve a snapshot periodically.

Features:

• Supports single or multiple camera streams/snapshots
• For multiple streams: supports rotating through streams in a single window or displaying multiple windows (with customizeable layout)
• Supports fetching snapshots from a file or url when not actively streaming
• Flexible configurations to limit resource use on Raspberry Pi –
  • Stops all streams when module is hidden
  • Option for AutoPlay or manual starting of stream
  • Plays one or all streams (when displaying multiple)
  • ffmpeg process only started when active stream window is shown and customizeable delay for shutdown after stopping.
  • Note: 3 simultaneous streams on a RaspberryPi 3 is about the limit for usability.
• Support for MMM-KeyBindings module for Play/Pause Remote Control and navigation of multiple streams

Screenshot:

Download:

[card:shbatm/MMM-RTSPStream]

---

Version 1.2.1 (Updated 15 Oct 2017)

• Now uses hardware-accelerated OMXPlayer as default player for local video
• Resolved latency issues
• Uses PM2 to control stream playback – automatically restarts streams when they close
• Fullscreen, custom window and offset options now available.
• Important - please update your configurations after updating this module. A new configuration tool is available, see the README on GitHub for info.

Version 1.0.0

• Initial Release – Please submit bugs and issues via GitHub Issues

Description

I created an updated version of @Jopyth’s excellent MMM-Remote-Control module with an extensible REST API for controlling everything about your mirror, as well as an upgrade of the /remote.html tool to use the module’s node_helper socket connection for communication back and forth–instead of get/post calls.

Example REST Calls:

Turn on the monitor

GET /api/monitor/on  (curl -X GET 'http://magicmirror:8080/api/monitor/on')

Hide All Modules

GET /api/modules/all/hide (curl -X GET 'http://magicmirror:8080/api/modules/all/hide')

Here’s the link to the API README and API Documentation. The API also includes the ability to automatically interpret other modules’ anticipated notifications to create a “guessed” API to control it (created from MMM-API). Modules’ can also send a notification to this module to explicitly declare their own API actions.

This is still in testing, and I’m still adding a few features, but I wanted to share in case anyone is interested in testing as well.

Inspiration

I’ve now written several modules and end up constantly including similar functions into my code (things like monitor control, module switching, etc.) for the different modules and I wanted to start migrating to a “One Remote to Rule Them All”-style module. @Jopyth’s module is an awesome base with a lot of the functions needed already built in, but I also wanted to have a better RESTful interface (inspired by @juzim’s MMM-API module natively incorporated) so I could control the mirror from my home automation devices. Eventually, I’ll scrub my other modules like MMM-OnScreenMenu and MMM-KeyBindings to just call the functions from this module and keep them focused on their own key features.

Download

[card:shbatm/MMM-Remote-Control]
Recommend using the Develop Branch for most recent changes.

Key Features and Changes

Added:

• REST API interface for controlling all aspects of the MagicMirror from HTTP RESTful-style GET and POST calls, based on principles from MMM-Api
  • Full API Documentation at API/README.md
  • Extensible Actions – Interprets other modules’ notifications to “guess” an API, but also allows a module to explicitly provide API actions to use.
• Live daily updates of modules.json from the MagicMirror wiki, based on @eouia’s MMM-Remote-Control-Repository.
• Incorporated some features found in MMM-OnScreenMenu that were not originally in this module.
  • Monitor (Connected Screen) On-Off Status and Toggle
  • If using Electron: Open Dev Tools, Minimize, Toggle Fullscreen
• Configuration Option to send custom shell commands to use. Currently, only custom monitor on/off/status commands are supported. Addresses PR #99.

Changed:

• Updates to remote.html and the node_helper.js to use direct SocketIO communication back and forth instead of separate HTTP calls.
  • Future framework for following PM2 logs and more live update options.
• General clean-up and standardization of status reporting for GET and POST calls, to original URLs and to new API URLs.
• Updated to ES2015 (ES Version 6) function calls in most locations.
• Added USER_PRESENCE controls from AgP42, PR #84
• Added translations from BKeyport, PR #103
• Added SHOW/HIDE/TOGGLE ALL modules option per request from Rene1709, Issue #101

Description:

Monitor & Control an OctoPrint 3D Printer Server. Originally created by @DongerZonnie, expanded & updated by @shbatm

The module will allow you to:
View a live feed of the raspicam stream
Start and stop prints
View G-Code viewer
Manually control the printer
Recieve live updates on printer status

Screenshots:

Download:

[card:shbatm/octomirror-module]

---

Version 1.0.4

• Implemented translations feature and added English & German
• Added ability to show most recent temperatures
• Added ability to hide additional details when the printer is offline.

Version 1.0.3

• Added options to disable camera feed and customize stream URL.

Version 1.0.2

• Refactored to use OctoPrint Client JS library and provide live updates via SockJS connection.

Description:

MMM-KeyBindings is a Utility Module to accept inputs from an Amazon Fire Stick Remote (or any bluetooth-connected HID device) as well as generic keyboard inputs and pass them to other modules for control.

The module can perform basic functions such as turning on/off the screen based on certain remote keys, but the real power is in the ability to send key press notifications to other modules. My plan is to use this to control other plugins such as my fork of @barnabycolby’s MMM-Carousel (Fork w/ Navigation Enabled: MMM-Carousel w/ KeyBindings and MMM-ProfileSwitcher to switch screens based on remote control input. In the future I also plan to add an on-screen menu with functions similar to those found in the MMM-RemoteControl module.

See the README for full details on the features.

Download:

[card:shbatm/MMM-KeyBindings]

Version 1.3.0 - Updated 3-Jan-2019 - [BREAKING CHANGES] See details here

This has been helpful for me, but I didn’t see it mentioned anywhere, so I thought I’d share. For anyone looking for a simple way to automatically restart your MM² when you change the config.js file:

Note: This assumes you are using pm2 to start the server, as described here: Auto Starting MagicMirror

1. Create a file in the same location as your mm.sh script called mm.json.
2. Paste the contents of this gist into the file (adjust if needed for your setup).
3. Run pm2 stop mm && pm2 delete mm to stop & remove the current mm script.
4. Run pm2 start mm.json to restart MM. Now any time you change config.js, pm2 will automatically restart the process.
5. Run pm2 save to save your changes for the next reboot.

That’s it!

Originally inspired by: Restart Mirror?

Description:

Inspired by the MMM-OpenHABFloorplan module, this is a module for the MagicMirror² to connect to an ISY device from Universal Devices (http://www.universal-devices.com) using a WebSocket. It will display a floor plan showing live updates of which Insteon, Z-Wave, or ISYv5 Node Server devices are turned on/off (including dimming levels), which alarm zones are tripped, and the status of the thermostats.

Setup takes a little while as you have to create your own floorplan in SVG (Scalable Vector Graphics) format using something like Inkscape or Adobe Illustrator. It can be as simple or as complex as you want it to be, the most important thing is the tagging. Whatever style you make your lights, lamps, outlets, or devices–as long as you tag them with the correct ISY address format–they will be picked up by the module automatically and their status updated on the graphic. The screenshots above are an “extreme” example SVG image which was created from an AutoCAD blueprint originally, with icons from various sources dropped in to represent the devices. The config options for the module give you even more advanced control, by letting you set custom display options for the different devices.

New in version [1.0.7]+ – Control popups can now be enabled for various devices, to directly control your home automation from a touchscreen or any web browser with the MagicMirror page loaded.

Screenshots:

Live view:

Download:

[card:shbatm/MMM-ISY]

---

Version 1.0.7 - Initial Controls Implementation

Added: Initial implementation of a control system using Bootstrap 4 to display tooltip style popups when devices are clicked.

Version 1.0.0

• Initial Release

[EDITED 27-APR-18 WITH NEW VERSION]

Description:

MMM-JSONStatusChecker will periodically call a URL and display a “true / false” (or “connected / disconnected”) status based on the results of a value in a JSON response from the API call.

Multiple instances of the module can be used to call different URLs/APIs using the same background helper. Each instance has it’s own configuration and refresh time.

See the config options on GitHub for full details, but everything can be customized; including: the key/value in the response being evaluated, the icon displayed, the CSS classes applied for true/false, the text for each status, and even whether or not to show an alert on status change.

Screenshots:

Download:

[card:shbatm/MMM-JSONStatusChecker]

---

Version 1.0.0

• Initial Release;

Please let me know if you find this useful. leave any comments or issues here or in the GitHub Repo Issues.

New version posted with expanded options:

Version 0.1.3

• Added menu options for minimizing, toggle fullscreen mode, opening DevTools, stopping MM via PM2,
• Added delayed menu items (e.g. call a function after a certain timeout–like to turn off the mirror after X seconds)
• Added external control of the menu/functions from other modules via notifications–includes the ability to call any function the module knows how to handle, even if it’s not in the menu. This lets you use modules like MMM-Buttons or MMM-MPR121 to control the menu.

See the full details of everything the menu can do on the GitHub README:

[card:shbatm/MMM-OnScreenMenu]

Remember to re-run npm install after updating:

cd ~/MagicMirror/modules/MMM-OnScreenMenu
git pull
npm install