Connect:HexChat - Revision history

Russell: /* Connecting */ Replace references to Freenode

2021-05-26T17:13:20Z

Connecting: Replace references to Freenode

Russell: /* Note regarding HexChat Password Bug */ Suggest a work around

2020-12-13T18:33:25Z

Note regarding HexChat Password Bug: Suggest a work around

Russell at 18:28, 13 December 2020

2020-12-13T18:28:50Z

Russell: /* Connecting with eMule */ Minor mistake

2020-04-27T15:42:56Z

Connecting with eMule: Minor mistake

Russell: Guide to connecting with Hexchat

2020-04-27T15:41:27Z

Guide to connecting with Hexchat

New page

= Connecting with eMule =

This guide will tell you how to connect to our bouncers using the Hexchat IRC Client which is available at [https://hexchat.github.io/downloads.html https://hexchat.github.io/downloads.html]. This client can also be downloaded on most variations of linux using the following command:
apt-get install hexchat

For the purposes of this guide, we have used '''[https://hexchat.github.io/downloads.html HexChat 2.14.1]'''

== Configuration ==

HexChat needs to be configured to connect to our bouncer, so to do this we need to bring up the "Network List". If this hasn't appeared automatically when starting HexChat, navigate to "File -> Network List". You should be presented with a window like this:

[[File:Hexchat-networks.png|350px|Screenshot of the HexChat network list while adding a new network ]]

Click the add button and this will add a new entry to the list called "New Network". Double click the new entry and enter a name for your new network (i.e My BNC4FREE Bouncer). After that, hit return and then press the "Edit" button. You should now be presented with a window that looks like the below:

[[File:Hexchat-editnetwork.png|350px|Screenshot of the Hexchat's Edit Network ]]

The options in this window need to be configured/changed as follows:

{| class="wikitable"
! style="font-weight:bold;" | Option
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Value / Recommended Value
|-
| Server
| The server that your account has been added to (i.e apple.bnc4free.com) including the port number
Port 1337 for Non-SSL / Port 1339 for SSL
| <server>.bnc4free.com/1339
|-
| Connect to selected server only
| There should only be 1 server in the networks list as mentioned above but you can tick this to ensure only this server is connected to
| Checked
|-
| Connect to this network automatically
| This option will automatically connect to the network when you start Hexchat if it is checked
If this is not checked, you will need to manually open the network list and connect.
| Checked
|-
| Use SSL for all servers on this networks
| This option should be checked if you are using Port 1339 (SSL Port)This option should not be checked if you are using Port 1337 (Non-SSL Port)
| Checked
|-
| Accept invalid SSL certificates
| This option should only be checked if you recieve errors while connecting to the bouncer using SSL. (Please let us know if you do)
As of 2020, all our servers have valid SSL certificates that automatically update so this option is not required.
| Not Checked
|-
| Login Method
| This should be set to "Default" which sends the PASS command to Authenticate.
This can alternatively be set to "Server password (/PASS password)" which will authenticate as well.
| Default
|-
| Password
| This must be the username and password you use to authenticate to your bouncer
Alternatively if your account has multiple networks, this must be the username, password and
network name you wish to connect to on your account
| MyUserName:MyPassword
OR
MyUserName/NetworkName:MyPassword
|}

Once completed, press "Close".

== Connecting ==

If you have added the bouncer to the Network List as outlined in the steps above, open the network list using "File -> Network List" and select the network you have created then press the "Connect" button. If you have filled in all the fields correctly, you should now be connected and authenticated successfully to the bouncer.

You can also manually connect to your bouncer should you need to by using one of the following commands in Hexchat's server window.
/server <server> <port> <username>:<password>
or
/server <server> <port> <username>/<network name>:<password>

Examples of this are shown below:
/server apple.bnc4free.com +1339 TestOne:foo
or
/server apple.bnc4free.com +1339 TestOne/Freenode:foo

← Older revision		Revision as of 18:33, 13 December 2020
Line 88:		Line 88:
	MyUsername@MyClientName/SomeNetwork:ThisIsMyPasswordAndIWillNotEverForgetItBecauseImCo		MyUsername@MyClientName/SomeNetwork:ThisIsMyPasswordAndIWillNotEverForgetItBecauseImCo

−	This has been raised as a bug report and can be viewed [https://github.com/hexchat/hexchat/issues/1296 here]	+	The easiest work around to this is to use shorter client names or passwords. This has been raised as a bug report and can be viewed [https://github.com/hexchat/hexchat/issues/1296 here]

← Older revision		Revision as of 18:28, 13 December 2020
Line 79:		Line 79:
	or		or
	/server apple.bnc4free.com +1339 TestOne/Freenode:foo		/server apple.bnc4free.com +1339 TestOne/Freenode:foo
		+
		+
		+	=== Note regarding HexChat Password Bug ===
		+
		+	Hexchat has a bug whereby if your username, client name, network name and password equate to over 86 characters, the password field is truncated and logins to the bouncer will fail. For example, a login of
		+	MyUsername@MyClientName/SomeNetwork:ThisIsMyPasswordAndIWillNotEverForgetItBecauseImCool
		+	will fail and be truncated to
		+	MyUsername@MyClientName/SomeNetwork:ThisIsMyPasswordAndIWillNotEverForgetItBecauseImCo
		+
		+	This has been raised as a bug report and can be viewed [https://github.com/hexchat/hexchat/issues/1296 here]

← Older revision		Revision as of 15:42, 27 April 2020
Line 1:		Line 1:
−	= Connecting with ~~eMule~~ =	+	= Connecting with HexChat =

	This guide will tell you how to connect to our bouncers using the Hexchat IRC Client which is available at [https://hexchat.github.io/downloads.html https://hexchat.github.io/downloads.html]. This client can also be downloaded on most variations of linux using the following command:		This guide will tell you how to connect to our bouncers using the Hexchat IRC Client which is available at [https://hexchat.github.io/downloads.html https://hexchat.github.io/downloads.html]. This client can also be downloaded on most variations of linux using the following command:

@@ Line 78: / Line 78: @@
      /server apple.bnc4free.com +1339 TestOne:foo
 or
-     /server apple.bnc4free.com +1339 TestOne/Freenode:foo
+     /server apple.bnc4free.com +1339 TestOne/LiberaChat:foo