This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
matrix [2021/06/09 10:16] voice [Room and Account Names] |
matrix [2021/06/09 10:34] rubin |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Matrix ====== | + | ~~REDIRECT>:help:matrix~~ |
- | + | ||
- | ===== What is it? ===== | + | |
- | [[https:// | + | |
- | + | ||
- | Matrix is in active development and items and names of components may change over time, for progress reports you can view their [[https:// | + | |
- | + | ||
- | ===== What do I need to do to use the AfterNET home server? ===== | + | |
- | Before you can use the AfterNET home server you need to have an account with us. Currently you can do this by registering an account with our IRC services. Once you've done this your options include: | + | |
- | * [[https:// | + | |
- | * **NOTE** By default they use their home server, in order to use ours click Sign In, then click Change and make sure https:// | + | |
- | * [[https:// | + | |
- | * [[https:// | + | |
- | * [[https:// | + | |
- | * There are multiple other clients available but Element is the most feature-rich due to it being from the same team as Matrix. You can view a list of the other clients [[https:// | + | |
- | + | ||
- | ===== First Login With Element ===== | + | |
- | Because Matrix aims to be secure one of the first things it will do the first time you log in is to setup your security key. This will just be another password used in the event you need to restore your key should you lose it due to data loss or corruption. You can also use it to verify your login if you're doing a second login via another computer or mobile device (cross-signing). | + | |
- | + | ||
- | ===== Getting Around ===== | + | |
- | Once you get in you'll be greeted by a message telling you to find a room or begin a room. In order to search for rooms go ahead and click on the room explorer icon: {{: | + | |
- | A window will open showing all publicly listed rooms on the homeserver: | + | |
- | + | ||
- | By default you are seeing all rooms listed on AfterNET' | + | |
- | + | ||
- | ==== 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) | + | |
- | {{:: | + | |
- | + | ||
- | 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. | + | |
- | {{:: | + | |
- | ==== Room and Account Names ==== | + | |
- | * Matrix rooms utilize the following format, also called an alias: # | + | |
- | * Matrix accounts utilize the following format: @account: | + | |
- | * AfterNET IRC bridged rooms utilize the following format: # | + | |
- | * Other bridged networks and their room formats are available [[https:// | + | |
- | + | ||
- | Matrix' | + | |
- | + | ||
- | ==== Managing Rooms ==== | + | |
- | Matrix breaks users down into three categories for room members: Administrator, | + | |
- | + | ||
- | 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. | + | |
- | + | ||
- | In order to modify a room's setting, in Element, click on the gear icon in the top right {{:: | + | |
- | === General Settings === | + | |
- | This tab contains all the generic room settings such as name, topic, icon, you can also add the room alias, make the room public or private on the room explorer, flair from communities (still under heavy work), enable/ | + | |
- | + | ||
- | {{:: | + | |
- | === Security & Privacy === | + | |
- | The next tab, Security & Privacy, determines who can join the room, who can read the history of the room and whether or not the enable full encryption (you can only turn this on, it cannot be turned off) **Do not enable encryption on rooms that are bridged to IRC as this will make the bridge in that room fail to function.** | + | |
- | + | ||
- | {{:: | + | |
- | === Roles & Permission === | + | |
- | This tab is where you will define who can do what in your room or the room you are managing. This is also a way to reference who has what power levels that is non-default (0), by selecting custom level you can set a power level value different than 0, 50 and 100. | + | |
- | + | ||
- | {{:: | + | |
- | === Notifications and Advanced === | + | |
- | + | ||
- | These final two tabs are more for you and advanced users. Notifications defines the notification sound you'll hear if you get one on this room. Advanced will show you the current room version, the room's ID on the server and the dev tools which will give you a deep dive into the room's current state and settings. You should avoid devtools unless you know what you are doing. | + | |
- | + | ||
- | === Room Members / Users === | + | |
- | {{ : | + | |
- | + | ||
- | Normal users can view this as well, however the Admin Tools will not be available to them. This is also where you can set a user's power level, simply click on the edit icon next to the level. | + | |
- | + | ||
- | Verify sessions allows you to confirm that this user is who they say they are. | + | |
- | + | ||
- | === Other Room Items === | + | |
- | Commands you can use to manage the room: | + | |
- | * /op <user> [PL] - Gives the user power level 50 unless another PL is specified. | + | |
- | * /deop < | + | |
- | * /kick < | + | |
- | * /ban < | + | |
- | * /unban < | + | |
- | * /topic <topic - Sets the room's topic | + | |
- | + | ||
- | ==== Your User Settings (Element Client) ==== | + | |
- | {{ ::element_usersettings.png? | + | |
- | + | ||
- | === General === | + | |
- | 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. | + | |
- | + | ||
- | {{:: | + | |
- | === Appearance === | + | |
- | This tab allows you to customize the look of Element. | + | |
- | {{:: | + | |
- | + | ||
- | === Security & Privacy === | + | |
- | This tab shows you a number of security related items including: | + | |
- | * All currently logged in sessions with the ability to close them out (requires your password). | + | |
- | * Allows you to establish key backups. This is required if you want to view old encrypted messages. | + | |
- | * Setup and reset cross-signing between devices. | + | |
- | * Allows you to import and export your keys. This is required if you want to view old encrypted messages. | + | |
- | {{:: | + | |
- | + | ||
- | === Help & About === | + | |
- | This tab has a core button that you may need to use if Element glitches and that is the Clear cache and reload button. This does not affect your keys or your key backups. | + | |
- | + | ||
- | This tab also shows you the current version of Element as what as what servers are in use. | + | |
- | + | ||
- | {{:: | + | |
- | + | ||
- | === Flair, Preferences and Voice & Video === | + | |
- | * Flair is for Matrix communities and allows you to display the icon for it if a room is configured to show it. Presently communities is not very usable, however the Matrix team has stated a rebuild in forthcoming to make it more usable. | + | |
- | * 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. | + | |
- | + | ||
- | ===== 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: | + | |
- | 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' | + | |
- | + | ||
- | ==== Bridge Rooms ==== | + | |
- | As stated earlier, the name format for bridged rooms on AfterNET IRC is # | + | |
- | + | ||
- | Rooms not listed in the Room Explorer can be joined by doing /join # | + |