Installation

Installation

You need Java 17 or newer. The library has no runtime dependencies.

From the MirraNET Maven repository

Prebuilt versions are published by the CI server. Add the repository and the dependency to your pom.xml:

<repositories>
    <repository>
        <id>mirranet</id>
        <url>https://builds.mirranet.de/plugin/repository/everything/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>de.mirranet</groupId>
        <artifactId>midea-ac</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

For Gradle:

repositories {
    maven { url "https://builds.mirranet.de/plugin/repository/everything/" }
}

dependencies {
    implementation "de.mirranet:midea-ac:1.0.0"
}

Building it yourself

git clone https://github.com/LinzN/midea-ac.git
cd midea-ac
mvn install

mvn install builds the jar, runs the tests and puts the library into your local Maven repository. After that you only need the <dependency> block, no <repositories> entry.

Without Maven:

javac -d build $(find src/main -name '*.java')
jar --create --file midea-ac.jar --main-class de.mirranet.midea.ac.example.Cli -C build .

Just the jar

Download midea-ac-<version>.jar from the build server and put it on your classpath. The same jar is also the command line tool:

java -jar midea-ac-1.0.0.jar discover

Packages

Package	What's in it
de.mirranet.midea.ac	The client, configuration, state and enums. Almost everything you need.
de.mirranet.midea.ac.discovery	MideaDiscovery, finds units on the LAN
de.mirranet.midea.ac.cloud	MideaCloud, KeyResolver, the one-time token fetch
de.mirranet.midea.ac.protocol	The wire format. Only needed for your own low-level tooling.

Next: Finding your unit and token