Matrix How-To: Difference between revisions

From HOPE Wiki
Mal (talk | contribs)
more migration bits
add image of bot selection
 
(19 intermediate revisions by one other 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


== How to join chat ==
== How to join chat ==
[[File:Corebot image.png|thumb|right]]


* Create or sign in to a Matrix account
You can join using any Matrix account. If you need to set up a client and create an account, check below! Once you're signed up and signed in, just send the token you were emailed (HOPE2024-ABCD...) to '''@corebot:hope.net''' to get access to the HOPE XV space. If you have multiple tokens (for example, as both an attendee and a presenter), send each in its own message.
* 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]].
The bot will validate your token and send you an invite, which you can find in the Spaces section of the app (left bar on web/desktop, squares-and-circle icon at bottom right on mobile). Once you've accepted the invite you can explore the rooms in the space, like Announcements, Jobs & Gigs, Info Desk, and the chats for each scheduled talk.
 
For help check the troubleshooting section below or [[Conference_bot|CoreBot help]].


== 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. [[Conference_bot|More information]]


== Desktop and Mobile Matrix Clients ==
== Using 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).
We recommend [https://element.io/download 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.
If you are using the HOPE homeserver, you will need to set your client to talk to <code>hope.net</code>:


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]]
[[File:Element login screen emphasizing homeserver edit button.png|frameless|Screenshot of the Element Android login page with a red arrow pointing towards the Edit button at the top right]]
[[File:Element homeserver selection screen showing hope.net.png|frameless|Screenshot of the Element Android homeserver entry screen with red arrows pointing out the Server URL of hope.net and the Next button]]


[[File:Matrix-mobile-homeserver.png|440px|Screenshot overview of setting a custom homeserver in element]]
Once you are signed in to your account, send the HOPE bot (@corebot:hope.net) a direct message with the ticket code. [[Conference_bot|More information]]


== Troubleshooting ==
== 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.
* '''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 rooms''' or '''I can't join a rooms'''<br>Have you sent your HOPE2024-ABCD... token to the bot? Have you accepted the invite to the HOPE XV space? You should be able to
* '''I'm on desktop or web, and can't see any rooms'''<br>Click the HOPE XV space twice, or right click -> explore rooms, and you should see the Talks space and general rooms.
* '''I'm on mobile, and can't see any rooms'''<br>At the bottom right is a button with three squares and a circle. Tap that, tap "HOPE XV", tap "HOPE XV" at the top of your screen, tap "Explore rooms", and from there you can join the Talks space and general rooms.
* '''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 PM with the bot and create a new one. You may need to disable the "Never send encrypted messages to unverified sessions" 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 39: Line 38:
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 48: Line 47:
</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]]
[[File:Matrix_community_tooltip.png|420px|matrix community tooltip]]


== Join other unofficial rooms ==
== Join other unofficial rooms ==

Latest revision as of 23:31, 9 July 2024

How to join chat

You can join using any Matrix account. If you need to set up a client and create an account, check below! Once you're signed up and signed in, just send the token you were emailed (HOPE2024-ABCD...) to @corebot:hope.net to get access to the HOPE XV space. If you have multiple tokens (for example, as both an attendee and a presenter), send each in its own message.

The bot will validate your token and send you an invite, which you can find in the Spaces section of the app (left bar on web/desktop, squares-and-circle icon at bottom right on mobile). Once you've accepted the invite you can explore the rooms in the space, like Announcements, Jobs & Gigs, Info Desk, and the chats for each scheduled talk.

For help check the troubleshooting section below or 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. More information

Using Desktop and Mobile Matrix Clients

We recommend Element. It supports iOS, Android, and desktop (Windows/Mac/Linux).

If you are using the HOPE homeserver, you will need to set your client to talk to hope.net:

Screenshot of the Element Android login page with a red arrow pointing towards the Edit button at the top right Screenshot of the Element Android homeserver entry screen with red arrows pointing out the Server URL of hope.net and the Next button

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

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 rooms or I can't join a rooms
    Have you sent your HOPE2024-ABCD... token to the bot? Have you accepted the invite to the HOPE XV space? You should be able to
  • I'm on desktop or web, and can't see any rooms
    Click the HOPE XV space twice, or right click -> explore rooms, and you should see the Talks space and general rooms.
  • I'm on mobile, and can't see any rooms
    At the bottom right is a button with three squares and a circle. Tap that, tap "HOPE XV", tap "HOPE XV" at the top of your screen, tap "Explore rooms", and from there you can join the Talks space and general rooms.
  • 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 PM with the bot and create a new one. You may need to disable the "Never send encrypted messages to unverified sessions" 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

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