adrianromero/helloiot

HelloIoT is a MQTT dashboard application.

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.adrianromero:helloiot:1.1.040'
	}
	dependencies {
		implementation("com.github.adrianromero:helloiot:1.1.040")
	}
	<dependency>
	    <groupId>com.github.adrianromero</groupId>
	    <artifactId>helloiot</artifactId>
	    <version>1.1.040</version>
	</dependency>

                            
    libraryDependencies += "com.github.adrianromero" % "helloiot" % "1.1.040"
        
        

                            
    :dependencies [[com.github.adrianromero/helloiot "1.1.040"]]

Readme

HelloIoT Release

This project is not updated anymore. Please visit my new MQTT dasboard application inspired in HelloIoT MYHELLOIOT.

HelloIoT is a MQTT dashboard application. You can use HelloIoT as a MQTT client application to publish and subscribe to topics or you can use HelloIoT as a client platform to create your own dashboard. HelloIoT is a Java multiplatform application and it can run on Windows, MacOS, Linux or Android.

Screenshot

Getting started

Install and execute HelloIoT

To run HelloIoT for desktop systems, just download and uncompress the appropiate release file. The executable is located in image/bin/HelloIoT.

To run HelloIoT for Android you must allow your device to install unknown apps, download the following release file and install.

Install a MQTT Broker

To run HelloIoT you need to install a MQTT broker or you can use a public MQTT broker. Public MQTT brokers can be good for testing or prototyping purposes. There is a list of MQTT brokers in the MQTT Community Wiki, you can choose the broker that better fits your needs.

HelloIoT is developed and tested using Mosquitto but it will also work with other MQTT Brokers like HiveMQ, EMQTT, Moquette...

Execute HelloIoT from sources

If you prefer to run HelloIoT from sources clone the repository, build and execute. You will need Java 11 installed first.

git clone https://github.com/adrianromero/helloiot
cd ./helloiot
./gradlew run

Other MQTT tools

In the MQTT Community Wiki, you can find a list of client applications and tools. My favorites are:

  • MQTT.fx by Jens Deters and created with JavaFX.
  • mqtt-spy by Kamil Baczkowicz and also created with JavaFX.

Acknowledgments

  • Font Awesome 4.4.0 by @davegandy - http://fontawesome.io - @fontawesome License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
  • Roboto font https://www.google.com/fonts/specimen/Roboto (Apache License Version 2.0)
  • Sound clips from http://www.soundjay.com/
  • Medusa JavaFX library for Gauges by Gerrit Grunwald. https://github.com/HanSolo/Medusa (Apache License Version 2.0)
  • Eclipse Paho MQTT Java library. https://www.eclipse.org/paho/clients/java/ (Eclipse Public License 1.0)
  • Google Guice library. https://github.com/google/guice (Apache License Version 2.0)
  • JideSoft Common library. https://github.com/jidesoft/jidefx-oss (GPL version 2 with classpath exception)
  • Apache Commons IO. https://commons.apache.org/proper/commons-io/ (Apache License Version 2.0)
  • MQTT Bridge for IKEA Tradfri Light Gateway by Ben Hardill https://github.com/hardillb/TRADFRI2MQTT (Apache License Version 2.0)

License

HelloIoT is licensed under the GNU General Public License, Version 3, 29 June 2007