Difference between revisions of "Matrix How-To"

From HOPE Wiki
Jump to: navigation, search
m
m (→‎Troubleshooting: ok stop trying to verify)
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Migrate your account! ==
 
'''The hope.net Matrix server will be shut down''' a while after the conference ends. When this happens, all accounts, rooms, and communities on riot.hope.net/matrix.hope.net will disappear.
 
Before that happens, be sure to:
 
* Make contact with your new friends outside Matrix, or with accounts (both you and them!) not on hope.net:
 
* Create a new Matrix account on another homeserver, for example https://chat.fairydust.space/ or https://riot.privacytools.io/
 
* If you want to, [https://ems.element.io/tools/matrix-migration| migrate your account] from hope.net to your new homeserver
 
** Your old homeserver would be matrix.hope.net, and your new one would be e.g. matrix.fairydust.space
 
** For best results, sign out of both accounts while it runs - Make sure you wrote down your encryption key before signing out!
 
* Join #afterhope2020:fairydust.space to keep chatting
 
* If you have any problems, ask in the tech support channel!
 
 
 
== How to join chat ==
 
== How to join chat ==
  
* Create or sign in to a Matrix account
+
Send your token (HOPE2022-ABCD...) to @corebot:hope.net to get access to the chat rooms.
* Talk to our [[Conference_bot|CoreBot]] to get access to the chat rooms
 
  
 
For help with the bot, please see the [[Conference_bot|CoreBot help]].
 
For help with the bot, please see the [[Conference_bot|CoreBot help]].
Line 19: Line 7:
 
== Using the Web Client ==
 
== Using the Web Client ==
  
Visit https://chat.fairydust.space/ to create an account ([[Matrix_How-To#How_to_create_your_HOPE_Matrix_account_on_the_web_.28slideshow.29|walkthrough]]), then send the [[Conference_bot|bot]] (@corebot:hope.net) a direct message with the command <code>ticket</code> then your ticket code. [[Conference_bot|More information]]
+
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 ==
 
== Desktop and Mobile Matrix Clients ==
  
If you wish to use your own client instead of riot.hope.net, we recommend [https://element.io/get-started element]. It supports iOS, Android, and desktop (Windows/Mac/Linux).
+
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>matrix.fairydust.space</code> or <code>matrix.hope.net</code> depending on where you created your account. You can see a screenshot of how to do this below.
+
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 command <code>ticket</code> then your ticket code. [[Conference_bot|More information]]
+
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]]
 
[[File:Matrix-mobile-homeserver.png|440px|Screenshot overview of setting a custom homeserver in element]]
Line 34: Line 23:
  
 
* '''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.
 
* '''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 the ticket command and your code again, it will try again to invite you to rooms.
+
* '''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) ==
 
== How to create your HOPE Matrix account on the web (slideshow) ==
Line 40: Line 32:
 
Note: adding your email for registration is ''optional''. If you add an email you are required to verify it before you can log in.
 
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_fix.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 49: 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_legend.png|768px|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