Java client to drive roombas through mazes.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This is a little library that can act as a programmatic client for connecting to and driving a roombot.

To connect to the roombot simulator you would clone this repository and run a command like:


To connect to a physical roombot you can use the default channel and just point to the IP address of the roombot:

ant -Droomba-host=

You will see a lot of output about the messages received and sent by this client so you can decide how to customize it.

Getting Started

All depedencies have been added to the vendor/ directory at the root of the project, so setup should be very minimal.

You'll probably want to use an IDE of your choice, but an ant script is provided to work with any system.


To customize, open up src/ and begin coding the Roomba around the maze.


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


The project (minus the jars) is available as open source under the terms of the MIT License.