Navigation

    MagicMirror Forum

    • Register
    • Login
    • Search
    • Recent
    • Tags
    • Unsolved
    • Solved
    • MagicMirror² Repository
    • Documentation
    • Donate
    • Discord

    [MMM-Remote-Control](v2-dev) Extensible REST API, Dynamic Menus, and Socket Communications, plus other updates

    Development
    12
    75
    11761
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • S
      shbatm Module Developer last edited by shbatm

      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


      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
      N Cr4z33 2 Replies Last reply Reply Quote 4
      • S
        shbatm Module Developer last edited by shbatm

        Additional Features Added:

        • Dynamic Module Control menu – uses the new API to create a Module Control menu on the remote page to control other modules via notifications.
        • Custom Menu – ability to specify your own custom menu items from a file (for advanced users)
        • Use PM2 API to control restarts/stops of MM. Can also support starting/stopping other PM2 scripts by passing processName: “scriptToUse” in the query payload.

        Example Dynamic Menu for MMM-Carousel w/ Navigation

        0_1546390145459_ModuleMenuExample.png

        1 Reply Last reply Reply Quote 1
        • N
          nobita @shbatm last edited by

          @shbatm
          The first time I Install MMM-Remote-Control (by Jopyth ) before
          If I would like to use your MMM-Remote-Control (by shbatm)
          question
          I have to Remove from jopyth or not

          Thank so much

          S 1 Reply Last reply Reply Quote 0
          • S
            shbatm Module Developer @nobita last edited by

            @nobita said in [MMM-Remote-Control](v2-dev) Extensible REST API, Dynamic Menus, and Socket Communications, plus other updates:

            I have to Remove from jopyth or not

            You can checkout my fork/branch without removing @Jopyth’s by adding a remote:

            $ cd ~/MagicMirror/modules/MMM-Remote-Control
            $ git remote add shbatm https://github.com/shbatm/MMM-Remote-Control.git
            $ git fetch shbatm
            $ git checkout -b shbatm-develop shbatm/develop
            $ npm install
            

            After that you can switch back and forth using git checkout master and git checkout shbatm-develop

            N swvalenti 2 Replies Last reply Reply Quote 0
            • N
              nobita @shbatm last edited by

              @shbatm
              Thanks again

              1 Reply Last reply Reply Quote 0
              • D
                dazza120 last edited by

                Can this also update modules like MMM-Remote-Control-Repositories, in just this one module?

                S 1 Reply Last reply Reply Quote 0
                • S
                  shbatm Module Developer @dazza120 last edited by

                  @dazza120 said in [MMM-Remote-Control](v2-dev) Extensible REST API, Dynamic Menus, and Socket Communications, plus other updates:

                  Can this also update modules like MMM-Remote-Control-Repositories, in just this one module?

                  Yes. This version pulls the list of modules from the Wiki and updates the modules.json file when its started (at most 1x per day).

                  D Cr4z33 2 Replies Last reply Reply Quote 0
                  • D
                    dazza120 @shbatm last edited by

                    @shbatm cheers I’ve looked through the read me and I am completely lost, it’s not just like doing a git clone and then putting stuff in the config file 🧠😁

                    S 1 Reply Last reply Reply Quote 0
                    • Cr4z33
                      Cr4z33 @shbatm last edited by

                      This post is deleted!
                      1 Reply Last reply Reply Quote 0
                      • S
                        shbatm Module Developer @dazza120 last edited by

                        @dazza120 Sorry, I’ve been away. What are you lost with? Can I help point you in the right direction?

                        If you’re just looking to install this version, see a couple posts up. For the most part it functions just like the other version, but adds a lot of advanced control features on top–like controlling your mirror from a browser or home automation controller (via API) or adding module control menus to the existing “/remote.html” page.

                        Cr4z33 1 Reply Last reply Reply Quote 0
                        • 1
                        • 2
                        • 3
                        • 4
                        • 5
                        • 6
                        • 7
                        • 8
                        • 1 / 8
                        • First post
                          Last post
                        Enjoying MagicMirror? Please consider a donation!
                        MagicMirror created by Michael Teeuw.
                        Forum managed by Paul-Vincent Roll and Rodrigo Ramírez Norambuena.
                        This forum is using NodeBB as its core | Contributors
                        Contact | Privacy Policy