From fd4acdaaceb2b3287c90871256621748c28a5e3e Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 19:51:52 +0000 Subject: [PATCH 01/13] add a quick start page for weechat on tilde machine --- wiki/pages/weechat.md | 47 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 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..c5a9d21 --- /dev/null +++ b/wiki/pages/weechat.md @@ -0,0 +1,47 @@ +--- +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 localhost/6697 + /connect tilde + +This will connect you to the irc network via the local machine using a +regular connection (which is secure enough since it stays on the local +machine). 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 username + +## Register + +You now can register your username using your tilde email address as +described here: (nicks) + +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 + +Now disconnect and connect again to get your registered nickname + + /quit +run weechat again + /connect tilde + +Now you can join any channel, e.g. #helpdesk + -- 2.34.1 From 9f135e2e1e612858691c4a9b7f0c96cea62aafd6 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 19:59:55 +0000 Subject: [PATCH 02/13] change to plain connection to avoid cert error --- wiki/pages/weechat.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index c5a9d21..63ba73e 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -14,7 +14,7 @@ which is installed and requires minimal configuration. Start weechat on your linux shell and type the following commands: - /server add tilde localhost/6697 + /server add tilde localhost/6667 /connect tilde This will connect you to the irc network via the local machine using a @@ -26,6 +26,9 @@ the /nick command /nick username +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 -- 2.34.1 From 16cd767e10dc303f8db308d4d9c851b067de05f1 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 20:02:24 +0000 Subject: [PATCH 03/13] wiki link --- wiki/pages/weechat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 63ba73e..a938fa4 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -32,7 +32,7 @@ you had kind of bad luck. ## Register You now can register your username using your tilde email address as -described here: (nicks) +described here: [intro to nicks](nicks) After you have done that, you can set the username and password in the weechat settings to automatically log in and authenticate -- 2.34.1 From 0bba795b1c6ec9ae2ce02d490d6917957d8653a4 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 20:03:19 +0000 Subject: [PATCH 04/13] wiki link again --- wiki/pages/weechat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index a938fa4..8cccb25 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -32,7 +32,7 @@ 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) +described here: [intro to nicks](nicks.html) After you have done that, you can set the username and password in the weechat settings to automatically log in and authenticate -- 2.34.1 From 03978df9d16f1c5a5dec1fa6e26ab16332c3fbeb Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 20:04:23 +0000 Subject: [PATCH 05/13] formatting --- wiki/pages/weechat.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 8cccb25..884ad83 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -43,8 +43,10 @@ weechat settings to automatically log in and authenticate Now disconnect and connect again to get your registered nickname /quit + run weechat again + /connect tilde -Now you can join any channel, e.g. #helpdesk +Now you can join any channel, e.g. **#helpdesk** -- 2.34.1 From 27a5527fccf0f1166d4a1fd2dfc8bff167a1d9b6 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 20:05:19 +0000 Subject: [PATCH 06/13] formatting --- wiki/pages/weechat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 884ad83..9604483 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -44,7 +44,7 @@ Now disconnect and connect again to get your registered nickname /quit -run weechat again +run **weechat** again and then connect with /connect tilde -- 2.34.1 From a13374385a0fe7fc139f4cd147b02005f31ee4b5 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 21:12:10 +0000 Subject: [PATCH 07/13] note about settings --- wiki/pages/weechat.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 9604483..a70e861 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -34,6 +34,8 @@ you had kind of bad luck. 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 @@ -48,5 +50,23 @@ 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 or start private conversatins +with /msg 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) + -- 2.34.1 From 1644f446cecb127a52135dd5474f0643d03315cd Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 21:32:51 +0000 Subject: [PATCH 08/13] secure password --- wiki/pages/weechat.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index a70e861..1830220 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -42,6 +42,14 @@ weechat settings to automatically log in and authenticate /set irc.server.tilde.sasl_username /set irc.server.tilde.sasl_password +To store the password securely, 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 -- 2.34.1 From d548e43c007d7d6570a98df230bf9a77c8979c21 Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 22:51:02 +0000 Subject: [PATCH 09/13] use irc.tilde.chat and ssl connection --- wiki/pages/weechat.md | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 1830220..55642ee 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -14,20 +14,18 @@ which is installed and requires minimal configuration. Start weechat on your linux shell and type the following commands: - /server add tilde localhost/6667 + /server add tilde irc.tilde.chat/6697 -ssl /connect tilde -This will connect you to the irc network via the local machine using a -regular connection (which is secure enough since it stays on the local -machine). 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 +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 username + /nick newusername -If you didn't chose a username that is unique in the tilde network, -you had kind of bad luck. +(If you didn't chose a username that is unique in the tilde network, +you had kind of bad luck.) ## Register @@ -42,7 +40,8 @@ weechat settings to automatically log in and authenticate /set irc.server.tilde.sasl_username /set irc.server.tilde.sasl_password -To store the password securely, you can use secure settings like this +Or to store the password securely (which is preferred), you can use +secure settings like this /secure passphrase /secure set tilde_password @@ -67,9 +66,9 @@ in /whois you can use /set irc.server.tilde.realname "My real name" -You can join multiple channels with /j or start private conversatins -with /msg and navigate between the different windows with Control-N -and Control-P +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: -- 2.34.1 From bc53ed9220a2686ba22702720ee396eacdcc235f Mon Sep 17 00:00:00 2001 From: Alexander Date: Wed, 25 Jan 2023 22:54:36 +0000 Subject: [PATCH 10/13] formatting --- wiki/pages/weechat.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 55642ee..c08c411 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -68,9 +68,9 @@ in /whois you can use 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 +windows with Control-n and Control-p -To automatically connect to the tilde server on startup use: +To automatically connect to the tilde server on startup use /set irc.server.tilde.autoconnect on -- 2.34.1 From bcfd075ec1b52660dce6d29e376921afbf8ff618 Mon Sep 17 00:00:00 2001 From: Alexander Date: Thu, 26 Jan 2023 00:03:22 +0000 Subject: [PATCH 11/13] minor text corrections, make a few things clearer add a note to readme how to preview from a tilde server --- wiki/README.md | 5 +++++ wiki/pages/weechat.md | 19 ++++++++++--------- 2 files changed, 15 insertions(+), 9 deletions(-) diff --git a/wiki/README.md b/wiki/README.md index e9cca6a..b1140ef 100644 --- a/wiki/README.md +++ b/wiki/README.md @@ -30,6 +30,11 @@ php -S localhost:9000 this will run your site at http://localhost:9000/ +if you are running the development server on your tilde account, you +will not be able to access it on (hostname):9000 because it only runs +on localhost, but you can create a tunnel with +ssh -L 9000:localhost:9000 +to access from your localhost:9000 address * edit as needed! diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index c08c411..f5fc54e 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -12,25 +12,26 @@ which is installed and requires minimal configuration. ## First connection -Start weechat on your linux shell and type the following commands: +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 +username used is your linux account, this is has to be unique, if +someone else registered your name already and is online you will be +called **username1**, then you should chose another nickname. You do +that with /nick newusername (If you didn't chose a username that is unique in the tilde network, -you had kind of bad luck.) +you have kind of bad luck.) ## Register You now can register your username using your tilde email address as -described here: [intro to nicks](nicks.html) +described here: [intro to nicks](nicks) ## Setting login credentials @@ -67,13 +68,13 @@ 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 +conversations 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) +For more information about the program, see the [weechat +manual](https://weechat.org/files/doc/stable/weechat_user.en.html) -- 2.34.1 From 5a27f6161d38ce49b5efda016c2ae874472a26f0 Mon Sep 17 00:00:00 2001 From: Alexander Date: Fri, 27 Jan 2023 11:37:13 +0000 Subject: [PATCH 12/13] include changed suggested by khuxkm on the PR --- wiki/pages/weechat.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index f5fc54e..301b8ef 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -12,21 +12,21 @@ which is installed and requires minimal configuration. ## First connection -Start **weechat** on your linux shell and type the following commands +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 your linux account, this is has to be unique, if +username used is your linux account, this has to be unique, if someone else registered your name already and is online you will be -called **username1**, then you should chose another nickname. You do +called **username1** or similar, then you should chose another nickname. You do that with /nick newusername -(If you didn't chose a username that is unique in the tilde network, -you have kind of bad luck.) +(If you didn't choose a username that is unique in the tilde network, +you had kind of bad luck.) ## Register @@ -75,6 +75,6 @@ To automatically connect to the tilde server on startup use /set irc.server.tilde.autoconnect on -For more information about the program, see the [weechat -manual](https://weechat.org/files/doc/stable/weechat_user.en.html) +For more information about weechat, see the +[manual](https://weechat.org/files/doc/stable/weechat_user.en.html) -- 2.34.1 From eb691f4ab63a66aeb93ad771a6192ee0ea02ec10 Mon Sep 17 00:00:00 2001 From: Alexander Date: Sat, 28 Jan 2023 00:52:44 +0000 Subject: [PATCH 13/13] chose -> choose --- wiki/pages/weechat.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/wiki/pages/weechat.md b/wiki/pages/weechat.md index 301b8ef..4035a58 100644 --- a/wiki/pages/weechat.md +++ b/wiki/pages/weechat.md @@ -18,10 +18,10 @@ Start weechat on your linux shell and type the following commands: /connect tilde This will connect you to the irc network via a secure connection. The -username used is your linux account, this has to be unique, if -someone else registered your name already and is online you will be -called **username1** or similar, then you should chose another nickname. You do -that with +username used is your linux account, this has to be unique, if someone +else registered your name already and is online you will be called +**username1** or similar, then you should choose another nickname. You +do that with /nick newusername -- 2.34.1