Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

An Etherpad Lite client for Java

branch: master
A Java client for Etherpad Lite’s HTTP JSON API. Etherpad Lite is a collaborative editor provided by the Etherpad Foundation.

See for information on how to install and configure your own Etherpad Lite instance, and read for an in-depth description of Etherpad Lite’s HTTP API.

For now, the best documentation is reading through the methods available in the EPLiteClient class: The methods are 1:1 with the EPLite API methods.

Depends on JSON.simple ( version 1.1.1.

You may download pre-compiled .jar files from

HEAD currently targets Etherpad Lite API v1.2.1. The plan is to keep up with the most recent version of the Etherpad Lite API. (Note that we're talking about API versions here, not release versions).

org.etherpad_lite_client uses Maven. I freely admit that I don't know much about the Java ecosystem, so I welcome any feedback/pull resquests that help improve this project and its structure.

 EPLiteClient client = new EPLiteClient("http://localhost:9001", "K8OF91QMQYUvrNu3e9rJ7FnnVgaB3m9q");

 # Create pad and set text
 client.setText("my_pad", "foo!!");

 # Get pad text
 String text = client.getText("my_pad").get("text").toString(); 

 # Get list of all pad ids
 HashMap result = client.listAllPads();
 List padIds = (List) result.get("padIDs");

Testing requires a copy of EtherpadLite running at http://localhost:9001 with an API key of K8OF91QMQYUvrNu3e9rJ7FnnVgaB3m9q
Run tests with maven:

 mvn test
Something went wrong with that request. Please try again.