Skip to content


Repository files navigation


Simple web page for show subscribed topics from MQTT server. — Like twitter wall for your MQTT broker.

MQTT Wall Screenshot


Build Status Build list Codacy Badge

Main Goal

  • Clean and simple design
  • Nice on big screen with huge font (overhead projector during lecture)
  • Just subscription of single topic (including wild cards of course)


You can try demo using Mosquitto test server (


  1. Download MQTT wall package (stable version or latest build)
  2. In index.html file there is configuration, put there your broker connection (MQTT over websockets is required).


This project was created as demo for my talk about MQTT on conference Linux Days 2015. First version took me about one hour. Since then code base was completely rewritten.


You will need git, node.js, npm and grunt.

  1. Clone repository
git clone
cd mqtt-wall
  1. Install dev. dependencies
npm install
  1. Build source code and run dev. http server (http://localhost:3000/)
grunt serve

Alternatively you can run grunt build to build source code (new directory dist will show up) or run grunt watch that will stay running and build src. whenever source code changed. grunt server does both and additionally serve result via BrowserSync.

If you need dev. MQTT broker, go to

cd tools/test-broker
npm install
node test-broker.js


MQTT Wall Icon

Modified icon Magnifier with dollar made by Freepik from, licensed by CC 3.0 BY.

Favicon generated by