An instant messaging application with a self-hostable server.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
kske 837ed0106f
Bumped version to v0.2-beta
2 years ago
client Bumped version to v0.2-beta 2 years ago
common Bumped version to v0.2-beta 2 years ago
server Bumped version to v0.2-beta 2 years ago
.gitignore Add top level .settings folder to .gitignore 2 years ago
.project Refactor Maven Project Structure 2 years ago
LICENSE Refactor Maven Project Structure 2 years ago Update README 2 years ago
pom.xml Bumped version to v0.2-beta 2 years ago


Envoy is a messenger written in Java. On this page, the project is explained for different user groups.

Regular User

To use Envoy to join an existing server, download the client from the release page.

When starting it for the first time, you can register yourself at a server of your choice. After connecting to the server, you can add other users to your contact list and send them messages.

To chat with multiple users at once, you can create a group. If you want to transfer a file to another user, you can attach it to a message.

On the settings page some convenience features can be configured, as well as the color theme.

Server Administrator

To set up an Envoy server, download the package from the release page.

Because the project lacks external documentation for the moment, please refer to the Javadoc inside the source code to configure your Envoy instance.


Envoy is organized as a Maven project that is split into three modules.


  • Sending and receiving of messages, groups, sending images and voice messages
  • User interface (UI)
  • Client configuration
  • Advanced logging possibilities
  • Tons of Events to interact with
  • Detailed Javadoc to improve readability of code


  • Basic datatypes
  • Events sent between client and server
  • Configuration API
  • Logging API based on java.util.logging
  • Envoy-specific Exception
  • Useful utility classes


  • Non-blocking connectivity infrastructure based on java.nio
  • Processors to handle incoming events
  • Database connectivity
  • Databse entities
  • Utility classes to check client version compatability and password validity