Matrix How-To: Difference between revisions

From HOPE Wiki
Mal (talk | contribs)
add image of bot selection
 
(8 intermediate revisions by one other user not shown)
Line 1: Line 1:
== How to join chat ==
== How to join chat ==
[[File:Corebot image.png|thumb|right]]


Send your token (HOPE2022-ABCD...) to @corebot:hope.net to get access to the chat rooms.
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.


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 ==
REGISTRATION ON ELEMENT.HOPE.NET IS CURRENTLY DISABLED. If you'd like to use element.hope.net, please check back soon!


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]]).
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]]
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 element.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>element.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 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 your token (HOPE2022-ABCD...), 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 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.
* '''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 44: Line 50:


[[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