diff --git a/i2p2www/pages/site/docs/applications/irc.html b/i2p2www/pages/site/docs/applications/irc.html new file mode 100644 index 00000000..79af9bef --- /dev/null +++ b/i2p2www/pages/site/docs/applications/irc.html @@ -0,0 +1,235 @@ +{% extends "global/layout.html" %} +{% block title %}{% trans %}Configuring IRC Software{% endtrans %}{% endblock %} +{% block lastupdated %}2020-11{% endblock %} +{% block accuratefor %}0.9.47{% endblock %} +{% block content %} +
{% trans %} There are many IRC clients that can be used with I2P. In +fact, all IRC clients can be connected to the Irc2P Service by connecting +them to the IRC Tunnel.{% endtrans %}
+ +{% trans %}To configure any IRC client to chat on Irc2P, first, make sure that +your IRC tunnel is available. Visit the Hidden Services Manager +and look for Irc2P in your "Client Tunnels" section. If the "Status" indicator on +the right-hand side is yellow or green, your Irc2P tunnel is ready and you should +proceed to the next step.{% endtrans %}
+ +{% trans %}Any IRC client can be connected to this IRC tunnel, but detailed +instructions for several popular clients are provided below.{% endtrans %}
+ + +{% trans %}Pidgin is a very popular Instant Messaging client with built-in IRC +support. It is also possible to use it with many other kinds of chat service, and +it supports using multiple accounts at once and has a variety of plugin-ins. There +is a similar application for OSX called "Adium." The instructions for Pidgin are +similar in Adium. +{% endtrans %}
+ +{% trans %}After launching Pidgin, you should see a "Buddy List" window. From +that window, open the "Accounts" menu from the toolbar. Select "Manage Accounts" to +begin configuring your I2P account.{% endtrans %}
+ +{% trans %}Click the "Add" button. In the window that opens, select "IRC" under +"Protocol," and set the "Host" to 127.0.0.1. Then pick a username and password. IRC +does not require you to register a nickname to join, but you may if you wish, after +you connect to Irc2P.{% endtrans %}
+ +{% trans %}Navigate to the "Advanced" tab and set the "Port" field to 6668 and +make sure that SSL is disabled, since your tunnel has encryption provided +by I2P.{% endtrans %}
+ +{% trans %}Open the Server List menu of XChat and click the "Add" button.{% endtrans %}
+ +{% trans %}Create a new network named "Irc2P" to configure for I2P IRC. Click +the "Edit" button on the right-hand side.{% endtrans %}
+ +{% trans %}Change the value in "Servers" from the default to `localhost/6669`, +and configure the default channels you want to join. I suggest #i2p and #i2p-dev +{% endtrans %}
+ +{% trans %}Close the "Edit Server" window from to return to the Server List +page and click "Connect" to join I2PRC.{% endtrans %}
+ +{% trans %}Click on the "Chat" button in the toolbar at the top of the +Thunderbird window.{% endtrans %}
+ +{% trans %}Click the get started button to begin setting up Irc2P.{% endtrans %}
+ +{% trans %}In the first step, select "IRC" for your network type.{% endtrans %}
+ +{% trans %}Choose a nickname and set your IRC Server to 127.0.0.1, but do not +set a port.{% endtrans %}
+ +{% trans %}Set a password if you want.{% endtrans %}
+ +{% trans %}Configure the IRC Server with an alias like "Irc2P" and set the +port to 6668.{% endtrans %}
+ +{% trans %}If your summary looks like this, then you're ready to connect +with Irc2P.{% endtrans %}
+ +{% trans %}Revolution IRC is an easy to use IRC client for Android. It's able to +handle multiple accounts on multiple services, so you can use it for Irc2P and for +your non-I2P IRC networks as well.{% endtrans %}
+ +{% trans %}Click the "Add Server" button(Shaped like this: `+`) in the corner +to get started configuring Revolution IRC for I2P.{% endtrans %}
+ +{% trans %}Fill in the server name, change the address to "127.0.0.1" and the +port to 6668.{% endtrans %}
+ +{% trans %}Give yourself a nickname and configure some channels to automatically +join.{% endtrans %}
+ +{% trans %}Dispatch is a stable, self-hosted IRC client with a web interface. It +has native I2P configuration available by communicating over the{% endtrans %} SAM v3 API.
+ +{% trans %}Dispatch is configured with a file called `config.toml`, which you can +configure the common settings.{% endtrans %}
+ +{% trans %} {% endtrans %}
+
+# Defaults for the client connect form
+[defaults]
+name = "myinvisibleirc.i2p"
+host = "anircservergoeshere.b32.i2p"
+port = 6667
+channels = [
+ "#i2p",
+ "#i2p-dev"
+]
+server_password = ""
+ssl = false
+
+
+
+{% trans %}Eris is an easy-to-configure IRC server with self-configuring support +for I2P. If you want to run a private IRC server it's one of the easiest ways.{% endtrans %}
+ +{% trans %} This is a valid configuration of the Eris IRC server, but it uses a +default password for the admin account(admin). You should change the operator.admin.password +and account.admin.password before deploying to a real service.{% endtrans %}
+ +
+mutex: {}
+network:
+ name: Local
+server:
+ password: ""
+ listen: []
+ tlslisten: {}
+ i2plisten:
+ invisibleirc:
+ i2pkeys: iirc
+ samaddr: 127.0.0.1:7656
+ log: ""
+ motd: ircd.motd
+ name: myinvisibleirc.i2p
+ description: Hidden IRC Services
+operator:
+ admin:
+ password: JDJhJDA0JE1vZmwxZC9YTXBhZ3RWT2xBbkNwZnV3R2N6VFUwQUI0RUJRVXRBRHliZVVoa0VYMnlIaGsu
+account:
+ admin:
+ password: JDJhJDA0JGtUU1JVc1JOUy9DbEh1WEdvYVlMdGVnclp6YnA3NDBOZGY1WUZhdTZtRzVmb1VKdXQ5ckZD
+www:
+ listen: []
+ tlslisten: {}
+ i2plisten:
+ i2pinfoirc:
+ i2pkeys: iircwww
+ samaddr: "127.0.0.1:7656"
+templatedir: lang
+
+
+{% endblock %}
diff --git a/i2p2www/static/images/irc/pidgin-irc-0.png b/i2p2www/static/images/irc/pidgin-irc-0.png
new file mode 100644
index 00000000..35887455
Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-0.png differ
diff --git a/i2p2www/static/images/irc/pidgin-irc-1.png b/i2p2www/static/images/irc/pidgin-irc-1.png
new file mode 100644
index 00000000..68fc5c79
Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-1.png differ
diff --git a/i2p2www/static/images/irc/pidgin-irc-2.png b/i2p2www/static/images/irc/pidgin-irc-2.png
new file mode 100644
index 00000000..61bc3993
Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-2.png differ
diff --git a/i2p2www/static/images/irc/pidgin-irc-3.png b/i2p2www/static/images/irc/pidgin-irc-3.png
new file mode 100644
index 00000000..16132c36
Binary files /dev/null and b/i2p2www/static/images/irc/pidgin-irc-3.png differ
diff --git a/i2p2www/static/images/irc/revolution-irc-0.png b/i2p2www/static/images/irc/revolution-irc-0.png
new file mode 100644
index 00000000..ad813236
Binary files /dev/null and b/i2p2www/static/images/irc/revolution-irc-0.png differ
diff --git a/i2p2www/static/images/irc/revolution-irc-1.png b/i2p2www/static/images/irc/revolution-irc-1.png
new file mode 100644
index 00000000..03c27097
Binary files /dev/null and b/i2p2www/static/images/irc/revolution-irc-1.png differ
diff --git a/i2p2www/static/images/irc/revolution-irc-2.png b/i2p2www/static/images/irc/revolution-irc-2.png
new file mode 100644
index 00000000..56739860
Binary files /dev/null and b/i2p2www/static/images/irc/revolution-irc-2.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-0.png b/i2p2www/static/images/irc/thunderbird-irc-0.png
new file mode 100644
index 00000000..f933be0b
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-0.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-1.png b/i2p2www/static/images/irc/thunderbird-irc-1.png
new file mode 100644
index 00000000..32b4455b
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-1.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-2.png b/i2p2www/static/images/irc/thunderbird-irc-2.png
new file mode 100644
index 00000000..94ef92fd
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-2.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-3.png b/i2p2www/static/images/irc/thunderbird-irc-3.png
new file mode 100644
index 00000000..c8daa639
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-3.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-4.png b/i2p2www/static/images/irc/thunderbird-irc-4.png
new file mode 100644
index 00000000..b00acb6f
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-4.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-5.png b/i2p2www/static/images/irc/thunderbird-irc-5.png
new file mode 100644
index 00000000..b2781da5
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-5.png differ
diff --git a/i2p2www/static/images/irc/thunderbird-irc-6.png b/i2p2www/static/images/irc/thunderbird-irc-6.png
new file mode 100644
index 00000000..1c8a441d
Binary files /dev/null and b/i2p2www/static/images/irc/thunderbird-irc-6.png differ
diff --git a/i2p2www/static/images/irc/tuncheck-irc-all.png b/i2p2www/static/images/irc/tuncheck-irc-all.png
new file mode 100644
index 00000000..c6eb1d96
Binary files /dev/null and b/i2p2www/static/images/irc/tuncheck-irc-all.png differ
diff --git a/i2p2www/static/images/irc/xchat-irc-0.png b/i2p2www/static/images/irc/xchat-irc-0.png
new file mode 100644
index 00000000..493d9b4f
Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-0.png differ
diff --git a/i2p2www/static/images/irc/xchat-irc-1.png b/i2p2www/static/images/irc/xchat-irc-1.png
new file mode 100644
index 00000000..9f5a9cba
Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-1.png differ
diff --git a/i2p2www/static/images/irc/xchat-irc-2.png b/i2p2www/static/images/irc/xchat-irc-2.png
new file mode 100644
index 00000000..4568727c
Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-2.png differ
diff --git a/i2p2www/static/images/irc/xchat-irc-3.png b/i2p2www/static/images/irc/xchat-irc-3.png
new file mode 100644
index 00000000..2fd3f29c
Binary files /dev/null and b/i2p2www/static/images/irc/xchat-irc-3.png differ