Editing Matrix (section)

== Bridging ==

Proprietary chat services such as Discord, Telegram, and WhatsApp can be bridged to Matrix, allowing you to communicate with users on the target network.

Currently, we offer Telegram and IRC bridges for our users. Otherwise, several public bridges are available, such as [https://t2bot.io t2bot] for Discord and Telegram.

=== Telegram ===

Currently, only puppeting is enabled on this instance.

To set up puppeting for your Telegram account:
# Create a direct chat with [https://matrix.to/#/@telegrambot:pub.solar @telegrambot:pub.solar] and wait for it to join.
# Initiate the process by sending <code>login</code>.
# Either follow the link replied to log in via browser, or send your account's phone number directly to the chat.
# Follow further instructions from the bot.

Relay bridging (used to bridge rooms) may be set up in the future.

=== IRC ===

As of January 2024, [https://github.com/matrix-org/matrix-appservice-irc IRC bridging] to [https://libera.chat/ Libera Chat] (irc.libera.chat) and [https://interviewfor.red/en/starting.html Scratch IRC] (irc.scratch-network.net) is enabled.

Before reading on, try searching the public room list in your Matrix client to see if there is already an existing bridged room for the IRC channel you would like to join.

To join a channel on IRC from Matrix, simply join the room <code>#_<SERVER>_<CHANNEL></code>, where <code><nowiki><SERVER></nowiki></code> and <code><nowiki><CHANNEL></nowiki></code> correspond to the IRC server and channel on that IRC server. 

For example, to join the channel #pkgsrc on libera.chat IRC, join the Matrix room [https://matrix.to/#/#_libera_#pkgsrc:pub.solar #_libera_#pkgsrc:pub.solar]. One way of joining this room is by entering the following command in the chat box of any room in your Matrix client:
 /join #_libera_#pkgsrc:pub.solar


To check the IRC bridge status and to control your connection to IRC servers, start a chat with [https://matrix.to/#/@irc_bot:pub.solar @irc_bot:pub.solar]. This is your [https://matrix-org.github.io/matrix-appservice-irc/latest/admin_room.html IRC bridge admin room], where you can set your IRC Nick (username) and store a password if you registered a user on a given IRC server. ''Note that some IRC channels only allow registered users to join.'' Type <code>!help</code> in the chat box to find out available commands in the admin room.

{| class="wikitable"
|+Table of bridged IRC networks
!Network Name
!Room alias format
!Appservice user
|-
|libera.chat
|<code>#_libera_#channame:pub.solar</code>
|[https://matrix.to/#/@irc.libera.chat_NickServ:pub.solar @irc.libera.chat_NickServ:pub.solar]
|-
|Scratch
|<code>#_scratch_#channame:pub.solar</code>
|[https://matrix.to/#/@irc.scratch-network.net_NickServ:pub.solar @irc.scratch-network.net_NickServ:pub.solar]
|}
To check if the number of bridged IRC servers has changed in the mean time, inspect [https://git.pub.solar/pub-solar/infra/src/branch/main/hosts/nachtigall/apps/matrix/irc.nix the Nix configuration] and look for the entries below the line that says: <code>in {</code>.