|
|
@@ -1,10 +1,10 @@
|
|
|
-# DarkIRC: Strong Anonymity P2P Chat
|
|
|
+# ircd: Strong Anonymity P2P Chat
|
|
|
|
|
|
In DarkFi, we organize our communication using resilient and
|
|
|
-censorship-resistant infrastructure. For chatting, `darkirc` is a
|
|
|
+censorship-resistant infrastructure. For chatting, `ircd` is a
|
|
|
peer-to-peer implementation of an IRC server in which any user can
|
|
|
participate anonymously using any IRC frontend and by running the
|
|
|
-IRC daemon. `darkirc` uses the DarkFi P2P engine to synchronize chats
|
|
|
+IRC daemon. `ircd` uses the DarkFi P2P engine to synchronize chats
|
|
|
between hosts.
|
|
|
|
|
|
## Benefits
|
|
|
@@ -27,9 +27,9 @@ Follow the instructions in the
|
|
|
you have all the necessary dependencies.
|
|
|
|
|
|
```shell
|
|
|
-% git clone https://github.com/darkrenaissance/darkfi
|
|
|
-% cd darkfi
|
|
|
-% make darkirc
|
|
|
+% git clone https://github.com/darkrenaissance/darkfi.git
|
|
|
+% cd darkfi && git checkout v0.4.1
|
|
|
+% make ircd
|
|
|
```
|
|
|
|
|
|
## Installation (Android)
|
|
|
@@ -37,8 +37,8 @@ you have all the necessary dependencies.
|
|
|
This is for Android 64 bit (which is most phones).
|
|
|
|
|
|
1. Install Docker
|
|
|
-2. Run `cd bin/darkirc/ && make android`. The resulting file will be called
|
|
|
- `darkirc.aarch64-android`. Copy this to your phone.
|
|
|
+2. Run `cd bin/ircd/ && make android`. The resulting file will be called
|
|
|
+ `ircd.aarch64-android`. Copy this to your phone.
|
|
|
3. Install Termux and RevolutionIRC on F-Droid.
|
|
|
4. You can access the phone storage from `/sdcard/` and copy the file
|
|
|
into the Termux home.
|
|
|
@@ -49,41 +49,32 @@ This is for Android 64 bit (which is most phones).
|
|
|
|
|
|
## Usage (DarkFi Network)
|
|
|
|
|
|
-Upon compiling `darkirc` as described above, the preconfigured defaults
|
|
|
+Upon compiling `ircd` as described above, the preconfigured defaults
|
|
|
will allow you to connect to the network and start chatting with the
|
|
|
rest of the DarkFi community.
|
|
|
|
|
|
-First, try to start `darkirc` from your command-line so it can spawn its
|
|
|
+First, try to start `ircd` from your command-line so it can spawn its
|
|
|
configuration file in place. The preconfigured defaults will autojoin
|
|
|
you to several default channels one of which is `#dev` where we have
|
|
|
weekly meetings, and where the community is most active and talks
|
|
|
about DarkFi development.
|
|
|
|
|
|
```shell
|
|
|
-% ./darkirc
|
|
|
+% ./ircd
|
|
|
```
|
|
|
|
|
|
-`darkirc` will create a configuration file `darkirc_config.toml` by
|
|
|
+`ircd` will create a configuration file `ircd_config.toml` by
|
|
|
default in `~/.config/darkfi/` you can review and potentially edit. It
|
|
|
might be useful if you want to add other channels you want to autojoin
|
|
|
(like `#philosophy` and `#memes`), or if you want to set a shared
|
|
|
secret for some channel in order for it to be encrypted between its
|
|
|
participants.
|
|
|
|
|
|
-When done, you can run `darkirc` for the second time in order for it to
|
|
|
+When done, you can run `ircd` for the second time in order for it to
|
|
|
connect to the network and start participating in the P2P protocol:
|
|
|
|
|
|
```shell
|
|
|
-% ./darkirc
|
|
|
-```
|
|
|
-
|
|
|
-Whenever you edit `darkirc_config.toml` file and if you have your
|
|
|
-`darkirc` daemon running you don't need to restart it to reload the
|
|
|
-config, you just need to send a SIGHUP signal to it for the changes to
|
|
|
-reflect, one of the easiest ways to do that is:
|
|
|
-
|
|
|
-```shell
|
|
|
-% kill -SIGHUP $(pidof darkirc)
|
|
|
+% ./ircd
|
|
|
```
|
|
|
|
|
|
## Clients
|
|
|
@@ -92,7 +83,7 @@ reflect, one of the easiest ways to do that is:
|
|
|
|
|
|
In this section, we'll briefly cover how to use the [Weechat IRC
|
|
|
client](https://github.com/weechat/weechat) to connect and chat with
|
|
|
-`darkirc`.
|
|
|
+`ircd`.
|
|
|
|
|
|
Normally, you should be able to install weechat using your
|
|
|
distribution's package manager. If not, have a look at the weechat
|
|
|
@@ -100,9 +91,9 @@ distribution's package manager. If not, have a look at the weechat
|
|
|
on how to install it on your computer.
|
|
|
|
|
|
Once installed, we can configure a new server which will represent our
|
|
|
-`darkirc` instance. First, start weechat, and in its window - run the
|
|
|
+`ircd` instance. First, start weechat, and in its window - run the
|
|
|
following commands (there is an assumption that `irc_listen` in the
|
|
|
-`darkirc` config file is set to `127.0.0.1:6667`):
|
|
|
+`ircd` config file is set to `127.0.0.1:6667`):
|
|
|
|
|
|
```
|
|
|
/server add darkfi localhost/6667 -notls -autoconnect
|
|
|
@@ -132,7 +123,7 @@ connected hosts.
|
|
|
DarkFi supports the use of pluggable transports, including Tor and Nym,
|
|
|
to provide network-level privacy. As long as there are live seed nodes
|
|
|
configured to support a Tor or Nym connection, users can connect to
|
|
|
-`darkirc` and benefit from the protections offered by these protocols.
|
|
|
+`ircd` and benefit from the protections offered by these protocols.
|
|
|
|
|
|
Other approaches include connecting via a cloud server or VPN. Research
|
|
|
the risks involved in these methods before connecting.
|
|
|
@@ -218,7 +209,7 @@ servers:
|
|
|
|
|
|
/set irc.look.temporary_servers on
|
|
|
|
|
|
-Finally you can attach to the local darkirc instances:
|
|
|
+Finally you can attach to the local ircd instances:
|
|
|
|
|
|
/connect localhost/6667
|
|
|
/connect localhost/6668
|