This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
help:matrix [2020/10/26 12:15] rubin [Downloading Matrix] |
help:matrix [2023/10/14 14:19] (current) rubin [What do I need to do to use the AfterNET home server?] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== Matrix ====== |
- | We are experimenting with a new chat system called Matrix, and you can join us! Matrix is a next-gen open chat protocol designed to improve on IRC using modern tools. | + | ===== What is it? ===== |
+ | [[https:// | ||
- | AfterNET now runs an afternet.org matrix server, and it is bridged with IRC so you can join many AfterNET channels on matrix. | + | Matrix is in active development and items and names of components may change over time, for progress reports |
- | ===== Downloading | + | ===== 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:// | ||
+ | * [[https:// | ||
+ | * Element Mobile: [[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:// | ||
+ | * [[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). | ||
- | Choose | + | ===== 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: | ||
- | * iPhone users: Check out [[https:// | + | By default you are seeing all rooms listed on AfterNET' |
- | * Android users: Check out [[https:// | + | |
- | * Desktop users: Get a copy from [[https:// | + | |
- | * In-Browser: You can also just use your browser: [[https:// | + | |
- | ===== Connecting ===== | + | ==== Create A Room ==== |
- | * On the initial screen, choose "Log In" | + | Creating a room is pretty straightforward. You can do this from two locations, the Room Explorer (public assumed) and the + (private assumed) |
- | * Click the box next to " | + | |
- | * Enter the server url: '' | + | |
- | * For username and password, use your existing AfterNET account | + | |
- | ===== Getting Around ===== | + | 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) |
- | Channels from IRC show up as #irc_# | + | {{:: |
+ | |||
+ | 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 | ||
+ | * 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 - 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 {{:: | ||
+ | === 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 | ||
+ | |||
+ | {{:: | ||
+ | === 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 | ||
+ | |||
+ | {{:: | ||
+ | === 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 | ||
+ | |||
+ | === 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 < | ||
+ | * /deop < | ||
+ | * /kick < | ||
+ | * /ban < | ||
+ | * /unban < | ||
+ | * /topic <topic - Sets the room's topic | ||
+ | |||
+ | ==== Your User Settings (Element Client) ==== | ||
+ | {{ :: | ||
+ | |||
+ | === 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 | ||
+ | |||
+ | 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 | ||
+ | |||
+ | {{:: | ||
+ | === Appearance === | ||
+ | This tab allows you to customize | ||
+ | {{:: | ||
+ | |||
+ | === 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. | ||
+ | {{:: | ||
- | Matrix | + | === 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. | ||
- | Keep in mind this is all very new, and a little fresh, so it is not perfect! | + | This tab also shows you the current version of Element as what as what servers are in use. |
- | ===== Logging In ===== | + | {{:: |
- | You can trick your IRC side self into being logged in, to get access to restricted channels or whatever: | + | |
- | Start a new direct message with '' | + | === Flair, Preferences and Voice & Video === |
- | send the normal AUTH login command | + | * 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 |
+ | * 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. | ||
- | AUTH yourafternetusername yourafternetpassword | + | ===== Bridges ===== |
- | + | ==== Things To Know Going In ==== | |
- | You may have to repeat that later, if the bridge | + | |
+ | * Nothing is perfect and this is no different. The bridge | ||
+ | * **Lag exists.** Due to the way the homeserver and bridge | ||
- | ===== Other networks ===== | + | ==== @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. | ||
- | It is possible, due to the federated nature | + | 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' |
- | + | ||
- | Many freenode channels require registration, | + | |
+ | ==== 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 # | ||