aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTheJackiMonster <thejackimonster@gmail.com>2022-03-30 15:20:05 +0200
committerTheJackiMonster <thejackimonster@gmail.com>2022-03-30 15:20:05 +0200
commit1ba9b0280a52207e4ac4288f1427566f1d5667c4 (patch)
tree2a8fa8df2d4080af3782c6ee438b9cd99656e5c0
parent5076508d493b0f41036039e7984cd1377eda39d2 (diff)
downloadlibgnunetchat-1ba9b0280a52207e4ac4288f1427566f1d5667c4.tar.gz
libgnunetchat-1ba9b0280a52207e4ac4288f1427566f1d5667c4.zip
Updated README.md and AUTHORS file
Signed-off-by: TheJackiMonster <thejackimonster@gmail.com>
-rw-r--r--AUTHORS2
-rw-r--r--README.md49
2 files changed, 50 insertions, 1 deletions
diff --git a/AUTHORS b/AUTHORS
index 3bff6be..a3527de 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1 +1,3 @@
1Tobias Frisch <thejackimonster@gmail.com> 1Tobias Frisch <thejackimonster@gmail.com>
2Malte Voos <malte@malvo.org>
3Marcos Marado <mindboosternoori@gmail.com>
diff --git a/README.md b/README.md
index 3e120ca..6e8b47f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,50 @@
1# libgnunetchat 1# libgnunetchat
2 2
3A client-side library for applications to use the Messenger service of GNUnet. 3A client-side library for applications to utilize the Messenger service of GNUnet.
4
5## Features
6
7This library is an abstraction layer using the client API from different [GNUnet](https://www.gnunet.org) services to provide the functionality of a typical messenger application. The goal is to make developing such applications easier and independent of the GUI toolkit. So people can develop different interfaces being compatible with eachother despite visual differences, a few missing features or differences in overall design.
8
9Implementing all those typical features of a messenger application requires more than only a service to exchange messages. Therefore this library utilizes multiple different services provided by GNUnet to achieve this goal:
10
11 - [ARM](https://docs.gnunet.org/handbook/gnunet.html#Automatic-Restart-Manager-_0028ARM_0029) to automatically start all required services without manual setup from a user
12 - [FS](https://docs.gnunet.org/handbook/gnunet.html#File_002dsharing-_0028FS_0029-Subsystem) to upload, download and share files via the network in a secure way
13 - [GNS](https://docs.gnunet.org/handbook/gnunet.html#GNU-Name-System-_0028GNS_0029) to resolve published records of open lobbies, potentially exchanging contact credentials and opening a chat
14 - [IDENTITY](https://docs.gnunet.org/handbook/gnunet.html#IDENTITY-Subsystem) to create, delete and manage accounts as well as providing information to verify another users identity
15 - [MESSENGER](https://docs.gnunet.org/handbook/gnunet.html#MESSENGER-Subsystem) to open, close and manage any kind of chats as well as exchanging messages in a decentralized and secure way with other users
16 - [NAMESTORE](https://docs.gnunet.org/handbook/gnunet.html#NAMESTORE-Subsystem) to store contact and group chat information locally and to publish records of lobbies accessible via GNS
17 - [REGEX](https://docs.gnunet.org/handbook/gnunet.html#REGEX-Subsystem) to publish peer information allowing other peers to quickly form a public group chat around a certain topic
18
19## Build & Installation
20
21The following dependencies are required and need to be installed to build the library:
22
23 - [gnunet](https://git.gnunet.org/gnunet.git/): For using GNUnet services and its datatypes
24
25Then you can simply use the provided Makefile as follows:
26
27 - `make` to just compile everything with default parameters
28 - `make clean` to cleanup build files in case you want to recompile
29 - `make debug` to compile everything with debug parameters
30 - `make release` to compile everything with build optimizations enabled
31 - `make install` to install the compiled files (you might need sudo permissions to install)
32 - `make docs` to build Doxygen documentation ([Doxygen](https://www.doxygen.nl/index.html) is required to do that)
33 - `make check` to test the library with automated unit tests ([Check](https://libcheck.github.io/check/) is required to do that)
34
35## Contribution
36
37If you want to contribute to this project as well, the following options are available:
38
39 * Contribute directly to the [source code](https://git.gnunet.org/libgnunetchat.git/) with patches to fix issues or provide new features.
40 * Open issues in the [bug tracker](https://bugs.gnunet.org/bug_report_page.php) to report bugs, issues or missing features.
41 * Contact the authors of the software if you need any help to contribute (testing is always an option).
42
43The list of all previous authors can be viewed in the provided [file](AUTHORS).
44
45## Applications
46
47There are a few applications using this library already. So users can choose from any of them picking their favourite interface for messaging:
48
49 * [Messenger-GTK](https://git.gnunet.org/messenger-gtk.git/): A GTK based GUI for the Messenger service of GNUnet.
50 * [messenger-cli](https://git.gnunet.org/messenger-cli.git): A CLI for the Messenger service of GNUnet.