From e5eb43ecc65384134dc92a9a6cc90061369401f0 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 23:09:11 +0000 Subject: [PATCH] quickstart guide for weechat (#56) A quick start guide to use weechat Since I never had used weechat before, I got kind of stuck on the server connect, so I decided to write a guide Reviewed-on: https://tildegit.org/tildeverse/tilde.chat/pulls/56 Co-authored-by: Alexander Co-committed-by: Alexander --- wiki/pages/weechat.md | 79 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 wiki/pages/weechat.md diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md new file mode 100644 index 0000000..c08c411 --- /dev/null +++ b/wiki/pages/weechat.md @@ -0,0 +1,79 @@ +--- +author: ~alexlehm +published: true +title: getting started with weechat on a tilde machine +description: run weechat as a local irc client +category: + - main +--- + +If you want to run irc on your tilde account, you can use weechat +which is installed and requires minimal configuration. + +## First connection + +Start weechat on your linux shell and type the following commands: + + /server add tilde irc.tilde.chat/6697 -ssl + /connect tilde + +This will connect you to the irc network via a secure connection. The +username used is the same as your linux account, this is should be +unique, if it is not you will be called username1 or similar, then you +should chose another nickname. You do that by using the /nick command + + /nick newusername + +(If you didn't chose a username that is unique in the tilde network, +you had kind of bad luck.) + +## Register + +You now can register your username using your tilde email address as +described here: [intro to nicks](nicks.html) + +## Setting login credentials + +After you have done that, you can set the username and password in the +weechat settings to automatically log in and authenticate + + /set irc.server.tilde.sasl_username + /set irc.server.tilde.sasl_password + +Or to store the password securely (which is preferred), you can use +secure settings like this + + /secure passphrase + /secure set tilde_password + /set irc.server.tilde.sasl_password "${sec.data.tilde_password}" + +Then the client will ask you for the passphrase when starting. + +Now disconnect and connect again to get your registered nickname + + /quit + +run **weechat** again and then connect with + + /connect tilde + +## What now + +Now you can join any channel, e.g. **#helpdesk** + +You can set various parameters, e.g. to set your real name displayed +in /whois you can use + + /set irc.server.tilde.realname "My real name" + +You can join multiple channels with /j #channel or start private +conversatins with /msg nickname and navigate between the different +windows with Control-n and Control-p + +To automatically connect to the tilde server on startup use + + /set irc.server.tilde.autoconnect on + +For more information about the program, see the +[manual](https://weechat.org/files/doc/stable/weechat_user.en.html) +