Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
matrix [2020/08/09 12:04]
voice [Your User Settings]
matrix [2021/06/09 10:17]
voice
Line 1: Line 1:
 +====== Matrix ======
 +
 ===== What is it? ===== ===== What is it? =====
-[[https://matrix.org/|Matrix]] is a next generation communication protocol with the end goal of being open standard for secure, decentralised, real-time communication. Part of what makes Matrix interesting is how the protocol was designed with bridging in mind, and one of these bridges is for IRC. AfterNET has decided to stand up our own federated Matrix home server with bridging to the IRC network to expand on available ways to communicate / participate through the AfterNET community. Think of Matrix as basically  Slack / Discord, only its open in both its protocol and source, it also permits federation with other servers / communities.+[[https://matrix.org/|Matrix]] is a next generation communication protocol with the end goal of being an open standard for secure, decentralized, real-time communication. Part of what makes Matrix interesting is how the protocol was designed with bridging in mind, and one of these bridges is for IRC. AfterNET has decided to stand up our own federated Matrix home server with bridging to the IRC network to expand on available ways to communicate / participate through the AfterNET community. Think of Matrix as basically  Slack / Discord, only its open in both its protocol and source, it also permits federation with other servers / communities.
  
 Matrix is in active development and items and names of components may change over time, for progress reports you can view their [[https://matrix.org/blog/category/this-week-in-matrix|This Week in Matrix]] blog posts. Matrix is in active development and items and names of components may change over time, for progress reports you can view their [[https://matrix.org/blog/category/this-week-in-matrix|This Week in Matrix]] blog posts.
Line 11: Line 13:
   * [[https://riot.afternet.org/|Our own hosted instance of Element]] - Same as above but configured for our homeserver by default.   * [[https://riot.afternet.org/|Our own hosted instance of Element]] - Same as above but configured for our homeserver by default.
   * [[https://play.google.com/store/apps/details?id=im.vector.app|Android]] and [[https://apps.apple.com/us/app/element/id1083446067|iOS]] versions are also available.   * [[https://play.google.com/store/apps/details?id=im.vector.app|Android]] and [[https://apps.apple.com/us/app/element/id1083446067|iOS]] versions are also available.
-  * There are multiple other clients available but Element is the most feature-rich due to it being from the same team as MatrixYou can view a list of them [[https://matrix.org/clients/|here.]]+  * There are multiple other clients available but Element is the most feature-rich due to it being from the same team as MatrixYou can view a list of the other clients [[https://matrix.org/clients/|here.]]
  
 ===== First Login With Element ===== ===== First Login With Element =====
Line 21: Line 23:
  
 By default you are seeing all rooms listed on AfterNET's homeserver. We also have our web client configured to allow you to view the rooms on Matrix's homeserver and other clients can add different servers as well. To do so click the dropdown Matrix rooms, for our hosted Element you can select matrix.org and view their rooms or you can select Add a new server and enter a server such as Mozilla's server at mozilla.org By default you are seeing all rooms listed on AfterNET's homeserver. We also have our web client configured to allow you to view the rooms on Matrix's homeserver and other clients can add different servers as well. To do so click the dropdown Matrix rooms, for our hosted Element you can select matrix.org and view their rooms or you can select Add a new server and enter a server such as Mozilla's server at mozilla.org
 +
 +==== Create A Room ====
 +Creating a room is pretty straightforward. You can do this from two locations, the Room Explorer (public assumed) and the + (private assumed) next to Rooms on the left-hand side.
 +
 +If you create a room from the Room Explorer the following screen appears as it will assume its a public room, it allows you to set the room name, the topic, whether it will show in the explorer or not, the room address / alias, and under Advanced whether or not you want users from servers other than afternet.org to be able to join (this can only be enabled, not disabled)
 +{{::element_createroom.png?nolink&400|}}
 +
 +If you use the + to create a new room it will assume you are attempting to make a private room so the following screen will appear. In addition to making it public or blocking remote homeserver users it will also default to enabling encryption on the room. Encryption and remote homeserver are one-time options and cannot be changed after they are set.
 +{{::element_createroom2.png?nolink&400|}}
 ==== Room and Account Names ==== ==== Room and Account Names ====
-  * Matrix rooms utilize the following format, also called an alias: #roomname:homeserver.tld+  * Matrix rooms utilize the following format, also called an alias: #roomname:homeserver.tld A room must have this set in order to be public, otherwise it is assumed to be private and invite only.
   * Matrix accounts utilize the following format: @account:homeserver.tld   * Matrix accounts utilize the following format: @account:homeserver.tld
-  * AfterNET IRC bridged rooms utilize the following format: #irc_#channel:afternet.org+  * AfterNET IRC bridged rooms utilize the following format: #channel:afternet.org
   * Other bridged networks and their room formats are available [[https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks|here.]]   * Other bridged networks and their room formats are available [[https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks|here.]]
  
Line 34: Line 45:
 When you create a room you are by default a room Administrator but do **be careful** when changing power levels especially on yourself. If you were to lower yourself from 100 to anything less you cannot get 100 again and AfterNET staff will not be able to do so for you as well due to the federated nature of Matrix. You will need someone else in the room who is an Administrator to set you back to 100. When you create a room you are by default a room Administrator but do **be careful** when changing power levels especially on yourself. If you were to lower yourself from 100 to anything less you cannot get 100 again and AfterNET staff will not be able to do so for you as well due to the federated nature of Matrix. You will need someone else in the room who is an Administrator to set you back to 100.
  
-The IRC bridge on AfterNET is currently setup so that +o - 100, +h - 50 and +v - 1. If you are concerned about unauthorized users gaining +o and being able to wreck the matrix room note that the bridge does not allow room setting changes over the bridge aside from the room topic.+The IRC bridge on AfterNET is currently setup so that +o - 99, +h - 50 and +v - 1. If you are concerned about unauthorized users gaining +o and being able to wreck the matrix room note that the bridge does not allow room setting changes over the bridge aside from the room topic.
  
 In order to modify a room's setting, in Element, click on the gear icon in the top right {{::element_roomsettinggear.png?nolink&50|}} which will open the room settings. In order to modify a room's setting, in Element, click on the gear icon in the top right {{::element_roomsettinggear.png?nolink&50|}} which will open the room settings.
Line 75: Line 86:
 In this tab you can change your display name (by default your full account name is used), your avatar, change your password, attach an email / or phone number to your account so other users can use that to search for you in addition to your account or display name. In this tab you can change your display name (by default your full account name is used), your avatar, change your password, attach an email / or phone number to your account so other users can use that to search for you in addition to your account or display name.
  
-Also in this tab you can set your language and region, for advanced users specify your identity and integrations servers or you can deactivate your account. Note that deactivating your account will render it no longer usable on the AfterNET homeserver.{{::element_usersettings1.png?nolink&600|}}+Also in this tab you can set your language and region, for advanced users specify your identity and integrations servers or you can deactivate your account. Note that deactivating your account will render it no longer usable on the AfterNET homeserver. 
 + 
 +{{::element_usersettings1.png?nolink&600|}}
 === Appearance === === Appearance ===
 This tab allows you to customize the look of Element. This tab allows you to customize the look of Element.
Line 99: Line 112:
   * Preferences is just generic settings for Element   * Preferences is just generic settings for Element
   * Voice & Video configures the VoIP aspect of Element as Matrix is able to handle voice and video calls. Calls are made through Jitsi.   * Voice & Video configures the VoIP aspect of Element as Matrix is able to handle voice and video calls. Calls are made through Jitsi.
 +
 +===== Bridges =====
 +==== Things To Know Going In ====
 +  * The IRC bridges are managed by the homeserver operator they are attached to, ie: AfterNET manages the bridge to the AfterNET IRC network and matrix.org manages the bridge to the Freenode IRC network.
 +  * Nothing is perfect and this is no different. The bridge may from time to time exhibit odd behaviors such as communication going only one way, that is to say a user may send a message to a bridge room from the Matrix side but it wont make it to the IRC side or vice versa. This is a known issue with the bridging software.
 +  * **Lag exists.** Due to the way the homeserver and bridge service communicate it can take a little time for messages to process, it has been observed that this can take up to five minutes. This is likely due to a limitation in both the homeserver and the bridge software. //This is becoming less of an issue.//
 +
 +==== @appservice-irc:afternet.org ====
 +This is the virtual control user the bridge uses to communicate with you and you with it. When you join a room that is bridged to a IRC room the bridge will make a virtual user with your name and connect it to the network. Once this is done in addition to joining the IRC room you will receive an invite from this user, accept it so you can control your IRC side. Once you accept the invite it will put you in a room named AfterNET IRC Bridge status for the AfterNET bridge.
 +
 +Once in the control room you will receive status messages from the appservice user such as connection state. You can also issue commands from this room, type !help in the room to see a list of what you can do.
 +
 +**For AfterNET bridge users that are logged into the AfterNET homeserver** you'll notice one of the commands is the !storepass for authenticating to a IRC network's Auth/NickServ. You do not need to use this as we have modified the bridge so that if you log in and you're a AfterNET user you'll automatically be logged into your AuthServ account.
 +
 +==== Bridge Rooms ====
 +As stated earlier, the name format for bridged rooms on AfterNET IRC is #channel:afternet.org. So for example #linux on AfterNET IRC goes by #linux:afternet.org on the AfterNET homeserver.
 +
 +Rooms not listed in the Room Explorer can be joined by doing /join #channel:afternet.org in your Matrix client.