An instant messaging application with a self-hostable server.
This repository has been archived on 2021-12-05. You can view files and clone it, but cannot push or open issues/pull-requests.
 
 
Go to file
Kai S. K. Engelbart 544210a811
Merge pull request 'Upgrade to Event Bus 1.0.0' (#112) from event-bus-1.0.0 into develop
Reviewed-on: https://git.kske.dev/zdm/envoy/pulls/112
Reviewed-by: delvh <leon@kske.dev>
2021-02-20 22:29:38 +01:00
client Upgrade to Event Bus 1.0.0 2021-02-19 13:25:12 +01:00
common Upgrade to Event Bus 1.0.0 2021-02-19 13:25:12 +01:00
server Send Pending Messages After Successful Handshake (#111) 2020-12-02 21:21:00 +01:00
.gitignore Add top level .settings folder to .gitignore 2020-09-06 11:15:20 +02:00
.project Refactor Maven Project Structure 2020-07-13 15:16:22 +02:00
LICENSE Refactor Maven Project Structure 2020-07-13 15:16:22 +02:00
README.md Link to Documentation (Wiki) in README (#110) 2020-11-27 09:36:08 +01:00
pom.xml Bumped version to v0.2-beta 2020-09-27 17:13:38 +02:00

README.md

Envoy

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.

Additional info on how to use Envoy can be found here in the client section.

System requirements

To run Envoy, you have to install a Java Runtime Environment (JRE) of at least version 11. You can download an open source implementation from here.

If you are running a Linux distribution, make sure that an emoji font like Noto emoji is installed. Most major Linux distributions like Debian, Arch and Gentoo have a Noto emoji package available inside their package repositories.

Server Administrator

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

To configure the behavior of Envoy Server, please have a look at the documentation, specifically the server part.

System requirements

To run Envoy server, you have to install a JRE as mentioned above, as well as a database. In development, PostgreSQL is used, which you can download from here.

Look at the file META-INF/persistence.xml inside envoy-server.jar for the database configuration.

After creating a database and configuring the credentials, the server will initialize the necessary tables automatically.

Programmer

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

Client

  • 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

Common

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

Server

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