https://github.com/kevinnovak/matrix

Web app - Control an LED matrix in real-time.
https://github.com/kevinnovak/matrix

iot mosca mqtt mqtt-js paho-mqtt paho-python raspberry-pi

Last synced: 27 days ago
JSON representation

Web app - Control an LED matrix in real-time.

• Host: GitHub
• URL: https://github.com/kevinnovak/matrix
• Owner: KevinNovak
• License: mit
• Created: 2018-03-22T23:15:14.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-04-25T00:38:55.000Z (over 6 years ago)
• Last Synced: 2024-11-03T21:25:39.488Z (2 months ago)
• Topics: iot, mosca, mqtt, mqtt-js, paho-mqtt, paho-python, raspberry-pi
• Language: JavaScript
• Homepage: http://kevinnovak.me/matrix/
• Size: 796 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Matrix

### Control an LED matrix in real-time.

Leverages the MQTT protocol using Mosca, MQTT.js, and Paho Python.

![Matrix](https://i.imgur.com/xKW0vTJ.png)

[View screenshots from Redditors here](https://imgur.com/a/hmzj8Ev)

Broken into 3 main applications:

1. **MQTT/UI Server**

    * Single Node.js application with two main functions:

        1. Run a Mosca MQTT broker.

        2. Serve web pages using Express.

            * Each UI client subscribes to the Mosca broker.

    * Start with ```npm start```.

        * Remember to ```npm install```.

        * Requires a MongoDB instance.

        * NGINX is an optional dependency.

    * Commands:

        * View logs with ```pm2 logs matrix```.

        * See online users with ```pm2 trigger matrix online```.

        * Ban a user with ```pm2 trigger matrix ban ```.

        * Unban a user with ```pm2 trigger matrix unban ```.

2. **LED Client**

    * Raspberry Pi client which subscribes to the Mosca broker.

    * Controls an 8x8 RGB LED matrix.

    * Start with ```sudo python app.py```.

        * Requires Python 3.6 and dependencies in ```requirements.txt```.

        * Run ```pip install -r requirements.txt``` to install dependencies.

3. **Stream Server**

    * Streams live video of the LED matrix to the UI clients.

    * Runs on the same Raspberry Pi as the LED client.

    * Start with ```npm start```.

        * Remember to ```npm install```.

## References

* [Mosca](https://www.npmjs.com/package/mosca) by [Matteo Collina](https://github.com/mcollina) - Node.js MQTT broker

* [MQTT.js](https://www.npmjs.com/package/mqtt) by [Matteo Collina](https://github.com/mcollina) - Use MQTT in the browser

* [MQTT over WebSockets](https://github.com/mcollina/mosca/wiki/MQTT-over-Websockets) by [Matteo Collina](https://github.com/mcollina) - Use MQTT over WebSockets

* [Paho Python](https://www.eclipse.org/paho/clients/python/) by [Eclipse](https://www.eclipse.org/) - Use MQTT in Python

* [rpi_ws281x](https://github.com/jgarff/rpi_ws281x) by [Jeremy Garff](https://github.com/jgarff) - Control WS281X RGB LEDs through Raspberry Pi

* [raspivid-stream](https://www.npmjs.com/package/raspivid-stream) by [Tim Perry](https://github.com/pimterry) - Capture video from Raspberry Pi

* [pi-cam](https://github.com/pimterry/pi-cam) by [Tim Perry](https://github.com/pimterry) - Working example of raspivid-stream

* [h264-live-player](https://github.com/131/h264-live-player) by [François Leurent](https://github.com/131) - Play h264 video in the browser