Files
site/wiki/source/irc.md
deepend-tildeclub a32d553d27 Fix webchat link for Newnet IRC
Updated webchat link for Newnet IRC.
2025-12-31 19:11:10 -07:00

106 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Socializing and chat
author:
- emv
- benharri
- deepend
category: tutorials
---
## irc
Our main channel is on the [Newnet IRC Network](https://newnet.net).
The official channel for ~club is `#club`. Stop by and say hello!
> **New!** An *official secondary* channel is now open on the Zoite IRC
> Network in case Newnet ever has an outage (or if you just feel like
> hanging out elsewhere). Connect to **irc.zoite.net** on port **6670 SSL**
> and `/join #club` same welcoming vibe, different network.
run `chat` to open [weechat](https://weechat.org) auto-connected to our irc
server. try launching [tmux](tmux.html), [byobu](https://superuser.com/a/423397)
or [screen](screen.html) to keep your chat session running.
other clients like irssi are available as well! just connect to **irc.newnet.net**
on port **6697 TLS** and `/join #club`.
feel free to use Newnet's [webchat](https://newnet.net/chat.php?channel=%23club) if
you prefer.
some channels might require you to register your nickname with NickServ to post in them (e.g. #meta). NickServ acts like a regular user, so you communicate with it through `/msg`. steps:
1. [optional] set nickname: `/nick YourNick` - not necessary with weechat, since it connects you under your tilde.club username
2. register: `/msg NickServ REGISTER YourPassword youremail@example.com` - you can use your tilde.club e-mail address for this
3. wait for registration email with confirmation code
4. confirm: `/msg NickServ CONFIRM someCode`
after this, every time you reconnect to irc you will have to identify with nickserv again: `/msg NickServ IDENTIFY YourPassword`.
weechat tip: NickServ replies and error messages appear in the first buffer `tilde weechat` (use Alt + up/down to switch).
## WeeChat relays
WeeChat introduced [UNIX domain socket relays](https://weechat.org/files/doc/stable/weechat_user.en.html#relay_unix_socket)
in version 2.5, which is a much easier way to offer per-user relay access.
---
username.tildecities.com/weechat is configured to proxy to a per-user UNIX relay socket.
To get started:
1. In WeeChat:
* Set your relay password using `/secure`:
* `/secure set relay mysupersecretpassword`
* `/set relay.network.password "${sec.data.relay}"`
* Create the UNIX-socket relay.
* **tilde.clubs nginx proxy expects the socket in your home dir:**
* `/relay add unix.weechat ~/.weechat/relay_socket`
2. At your shell (permissions):
* Ensure nginx can traverse to the socket (execute-only is enough):
* `chmod o+x ~/.weechat`
* After WeeChat creates the socket, allow nginx to read/write it:
* `setfacl -m u:nginx:rw ~/.weechat/relay_socket`
3. In your relay client (WebSocket via tilde.club proxy):
WeeChat expects the WebSocket URI to end with `/weechat` for the weechat protocol.
(The tilde.club proxy endpoint should handle this mapping for you.)
* [glowing-bear](https://glowingbear.tilde.club/):
- relay host: `username.tildecities.com:443/weechat`
- relay port: `443`
- your relay password
* [weechat-android](https://github.com/ubergeek42/weechat-android) and [lith](https://github.com/lithapp/lith):
- connection type: WebSocket (SSL/TLS)
- relay host: `username.tildecities.com`
- relay port: `443`
- websocket path: `/weechat`
- your relay password
### Removing old relays
List relays:
* `/relay listrelay` (or `/relay listfull`)
Delete a relay:
* `/relay del <name>`
(Example: `/relay del unix.weechat`.)
## IRC Bouncer (ZNC)
NOTE: Email deepend or message him on IRC if you require ZNC access.
You can find a ZNC IRC Bouncer by going to: [https://services.tilde.club/znc](https://services.tilde.club/znc).
Use your tilde.club username and password for login.
To connect to your ZNC its at services.tilde.club Port: 6699(SSL)
NOTE: long passwords fail to authenticate with the ZNC server.