yisiqi / livereload-jvm

A micro http-server compatible with LiveReload 2 (protocol). Should be used at compile/build-time.

Overview

A micro http server useful for dev ONLY :

• serve static file
• notify change to client via LiveReload protocol (over socket)

Usages

The default port is 35729 (like define in the LiveReload protocol). If you change the port then you could not use the Browsers Extension for LiveReload, but it should works if you insert a JavaScript snippet in your pages.

Cli

Download the livereload-jvm-0.2.0-onejar.jar (or regular jar + all dependencies from maven central).

java -jar livereload-jvm-0.2.0-onejar.jar -d web/root/path [port]

Java integration

//#repo central m2:http://repo1.maven.org/maven2/

import java.nio.file.FileSystems;
import net_alchim31_livereload.LRServer; //#from net.alchim31:livereload-jvm:0.2.0

int port = 35729;
Path docroot = FileSystems.getDefault().getPath("web/root/path");
new LRServer(port, docroot).run(); // == start() + join()

If you provide a plugin for your builder (maven, ant, sbt, gradle, plob, ...), let me know.

Links

• Browsers Extension
• livereload-js the client side
• LiveReload Protocol
• LiveReload Gradle Plugin is based on livereload-jvm

Alternatives

• LiveReload 2/3 the main tool (Mac & Windows only) include GUI
• guard-livereload a LiveReload server-side for Guard (Ruby)
• grunt-reload a LiveReload server-side for Grunt (javascript/nodejs)
• LivePage an other way to "auto-reload"
• without LiveReload : cd web/root/path && python -m http.server 8000 (python)

License

• the project is under unlicense
• the project (source and binaries) include [livereload.js], livereload.js is under MIT