Difference between revisions of "Matrix How-To"

From HOPE Wiki
Jump to: navigation, search
m (→‎Troubleshooting: ok stop trying to verify)
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
== How to join chat ==
 +
 +
Send your token (HOPE2022-ABCD...) to @corebot:hope.net to get access to the chat rooms.
 +
 +
For help with the bot, please see the [[Conference_bot|CoreBot help]].
 +
 +
== Using the Web Client ==
 +
 +
Visit https://element.hope.net/ to create an account ([[Matrix_How-To#How_to_create_your_HOPE_Matrix_account_on_the_web_.28slideshow.29|walkthrough]]).
 +
Send the [[Conference_bot|bot]] (@corebot:hope.net) a direct message with the ticket code you were sent around the 17th. [[Conference_bot|More information]]
 +
 +
== Desktop and Mobile Matrix Clients ==
 +
 +
If you wish to use your own client instead of element.hope.net, we recommend [https://element.io/get-started element]. It supports iOS, Android, and desktop (Windows/Mac/Linux).
 +
 +
You will likely need to set the client to use your homeserver, like <code>element.hope.net</code>, depending on where you created your account. You can see a screenshot of how to do this below.
 +
 +
Once you are signed in to your account, send the [[Conference_bot|bot]] (@corebot:hope.net) a direct message with the ticket code. [[Conference_bot|More information]]
 +
 +
[[File:Matrix-mobile-homeserver.png|440px|Screenshot overview of setting a custom homeserver in element]]
 +
 +
== Troubleshooting ==
 +
 +
* '''The desktop client isn't working'''<br>Wait a few minutes and try again. Make sure you're using the correct homeserver (see above)! If it's still not working, try the web client.
 +
* '''I'm missing a channel''' or '''I can't join a channel'''<br>Send the bot your token (HOPE2022-ABCD...), it will try again to invite you to rooms.
 +
* '''I'm on mobile, and can't see any channels'''<br>At the bottom of your screen, on the left is a talk bubble symbol 💬 for PMs, and on the right is a # symbol for channels. Tap the #.
 +
* '''I sent my token to the bot, but it didn't respond'''<br>Make sure you're sending it in a PM - you may need to leave the room and create a new PM with the bot. You may need to disable the "Never send encrypted messages to unverified sessions from this session" setting. If all else fails, try again later, or see below.
 +
* '''I'm having another issue!'''<br>If you've gotten connected to Matrix, try the Tech Support room. If you can't get to that room, PM @mal:hope.net. If you can't connect at all, and googling hasn't helped, [helpdesk email tbd]
 +
 +
== How to create your HOPE Matrix account on the web (slideshow) ==
 +
 +
Note: adding your email for registration is ''optional''. If you add an email you are required to verify it before you can log in.
 
<gallery mode="slideshow">
 
<gallery mode="slideshow">
Image:matrix1.png|Direct your browser to https://riot.hope.net.
+
Image:matrix1_fix.png|Direct your browser to https://element.hope.net.
 
Image:matrix2.png|Enter your preferred signup details. You can always change your display name later, but you can't change your username, so choose wisely!
 
Image:matrix2.png|Enter your preferred signup details. You can always change your display name later, but you can't change your username, so choose wisely!
 
Image:matrix3.png|Check your email to click the verification link. It should arrive within a minute or two; so don't forget to check your spam folder.
 
Image:matrix3.png|Check your email to click the verification link. It should arrive within a minute or two; so don't forget to check your spam folder.
Line 9: Line 41:
 
</gallery>
 
</gallery>
  
A legend of some common functions in Element (Riot) are shown here.
+
A legend of some common functions in Element are shown here.
 +
 
 +
[[File:Matrix_legend.png|768px|matrix legend]]
 +
[[File:Matrix_community_tooltip.png|420px|matrix community tooltip]]
 +
 
 +
== Join other unofficial rooms ==
  
[[File:Matrix_legend.png|1000px|matrix legend]]
+
If you want to see the unofficial rooms click the icon to the right of the search bar to explore other rooms
  
[[File:Matrix_community_tooltip.png|1000px|matrix community tooltip]]
+
[[File:Other_rooms.png|matrix legend]]

Latest revision as of 21:29, 21 July 2022

How to join chat

Send your token (HOPE2022-ABCD...) to @corebot:hope.net to get access to the chat rooms.

For help with the bot, please see the CoreBot help.

Using the Web Client

Visit https://element.hope.net/ to create an account (walkthrough). Send the bot (@corebot:hope.net) a direct message with the ticket code you were sent around the 17th. More information

Desktop and Mobile Matrix Clients

If you wish to use your own client instead of element.hope.net, we recommend element. It supports iOS, Android, and desktop (Windows/Mac/Linux).

You will likely need to set the client to use your homeserver, like element.hope.net, depending on where you created your account. You can see a screenshot of how to do this below.

Once you are signed in to your account, send the bot (@corebot:hope.net) a direct message with the ticket code. More information

Screenshot overview of setting a custom homeserver in element

Troubleshooting

  • The desktop client isn't working
    Wait a few minutes and try again. Make sure you're using the correct homeserver (see above)! If it's still not working, try the web client.
  • I'm missing a channel or I can't join a channel
    Send the bot your token (HOPE2022-ABCD...), it will try again to invite you to rooms.
  • I'm on mobile, and can't see any channels
    At the bottom of your screen, on the left is a talk bubble symbol 💬 for PMs, and on the right is a # symbol for channels. Tap the #.
  • I sent my token to the bot, but it didn't respond
    Make sure you're sending it in a PM - you may need to leave the room and create a new PM with the bot. You may need to disable the "Never send encrypted messages to unverified sessions from this session" setting. If all else fails, try again later, or see below.
  • I'm having another issue!
    If you've gotten connected to Matrix, try the Tech Support room. If you can't get to that room, PM @mal:hope.net. If you can't connect at all, and googling hasn't helped, [helpdesk email tbd]

How to create your HOPE Matrix account on the web (slideshow)

Note: adding your email for registration is optional. If you add an email you are required to verify it before you can log in.

A legend of some common functions in Element are shown here.

matrix legend matrix community tooltip

Join other unofficial rooms

If you want to see the unofficial rooms click the icon to the right of the search bar to explore other rooms

matrix legend