/pmulchat

Chat Application running on libjpmul

Primary LanguageJavaOtherNOASSERTION

pmulchat

About

pmulchat is a simple chat application, similar to IRC, but relying on libjpmul to multicast messages.

Getting started

Step 1: Get pmulchat

Click here to download the runnable jar

Step 2: Starting it

pmulchat offers a range of command line options to the user. While it is possible to start it by simply clicking the JAR file, this will most likely cause libjpmul to bind to the wrong interface. See libjpmul configuration and libjpmul FAQ for details on these problems. Running

> java -jar pmulchat.jar --help

will yield the available command line options.

Step 3: Configuring it

Follow these steps to get a default configuration file:

  1. start pmulchat
  2. click the config button
  3. select file in the menu bar
  4. click write to file
  5. select a location to write the file

Alternatively use the file located at /res/default.conf.

Once you have the default configuration file, the parameters described in libjpmul configuration can be set in this file. It can then be loaded using the following command:

> java -jar pmulchat.jar -c [path to file]

All parameters pertaining purely to pmulchat and not libjpmul can either be edited at runtime in the corresponding configuration pane or set with command line flags described in the --help. If nescessary, they can also be specified with the -p flag.

An example of a topic file used when running the application in static multicast mode can be found at /res/topics.list.

User Manual

A more extensive user manual explaining the functionality within pmulchat can be found here.

Building pmulchat

Step 1: Get prerequisites

To build pmulchat you will need libjpmul and libjpmul-Configurator. Visit their project pages for the latest prebuilt JAR files, or for the source code.

Step 2: Get pmulchat source

Click here to download the source archive

Step 3: Setting up the project

Include either the libraries or the source code downloaded in step 1 in the build path of pmulchat.

Step 4: Build

Build the project. The main method is located in the MainView class.

Licence

libjpmul-Configurator is available under the modified 3-clause BSD license. See the LICENSE file for more information.