Matrix

Matrix on uuden polven pikaviestin, jolla pääsee Matrixin omien huoneiden lisäksi myös esimerkiksi IRC-kanaville, Telegramiin ja Whatsappiin. Matrixissa on keskustelukanava kaikille lyseolaisille. Matrix toimii sekä tietokoneilla että kännyköillä. Matrixista lisätietoja löytyy esimerkiksi täältä.

Matrixin käyttö

Matrixiin on saatavilla useita client-sovelluksia, mutta näistä suosituin on Riot:

  • Selaimella: riot.ouly.fi
  • Androidilla: RiotX on vielä betassa, mutta on parempi monella tapaa kuin mahdollisesti vakaampi Riot.im. Jos olet epävarma, Riot.im on vielä suositeltu.
  • IOSilla: Riot.im
  • Työpöytä: Riot on saatavilla työpöydälle (Linux, macOS, Windows) täällä.
    • Linux Mint -käyttäjät: Vaihda echo-alkuisessa komennossa "$(lsb_release -cs)" tilalle "bionic"

Lista muista Matrix-clienteistä: https://matrix.org/clients/

Kirjautuminen

!ÄLÄ LUO UUTTA TUNNUSTA RIOTISSA!

Voit kirjautua Lyseon Matrixiin Lyseo-tunnuksella, jonka voi hakea sähköisellä lomakkeella. Vaihda clientissäsi homeserver url:ksi https://lyseo.edu.ouka.fi (oletuksena yleensä https://matrix.org)

Mahdollisesti kiinnostavia kanavia

 

Nimimerkin vaihtaminen

  • Matrixin laajuisesti
    • Riot (ainakin työpöytä ja selain) -> Settings -> General -> Display Name
    • Missä vain: Kirjoita missä tahansa huoneessa /nick <haluamasi nimi>
  • Yhdessä huoneessa
    • Kirjoita haluamassasi huoneessa /myroomnick <haluamasi nimi>

 

Muihin pikaviestintäpalveluihin yhdistäminen (vapaaehtoinen)

IRCnet
  1. Yhdistä IRC-kanavalle #_ircnet_<kanavan nimi>:irc.snt.utwente.nl, esimerkiksi #_ircnet_#linux.fi:irc.snt.utwente.nl
  2. Jos haluat tietää nimimerkkisi IRCnetissä, lähetä viesti !nick käyttäjälle @ircnet:irc.snt.utwente.nl ja vaihtaaksesi !nick <haluttu nimimerkki>
Freenode
  1. Yhdistä IRC-kanavalle #freenode_<kanavan nimi>:matrix.org, esimerkiksi #freenode_#ltsp:matrix.org
  2. Jos haluat tietää nimimerkkisi Freenodessa, lähetä viesti !nick käyttäjälle @appservice-irc:matrix.org ja vaihtaaksesi !nick <haluttu nimimerkki>
  3. Jos haluat rekisteröidä nimimerkkisi niin, etteivät muut voi varata sitä: (Vaaditaan joillekkin irc-kanaville)
    1. Lähetä viesti REGISTER <salasana> <sähköpostiosoite> käyttäjälle @freenode_NickServ:matrix.org (Älä käytä muualla käyttämääsi salasanaa. Salasana tallennetaan raakatekstinä matrix.org-palvelimelle)
    2. Saat sähköpostiisi viestin Freenodelta. Lähetä sen käskemä rivi käyttäjälle @freenode_NickServ:matrix.org lukuunottamatta alkua /msg NickServ
    3. Lähetä käyttäjälle @freenode_NickServ:matrix.org viesti IDENTIFY <salasana>
    4. Lähetä käyttäjälle @appservice-irc:matrix.org viesti !storepass <salasana>

Muut IRC-verkot

Lista sillatuista verkoista löytyy osoitteesta https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks. Asiat toimii niissä vastaavasti kuin IRCnetissä ja Freenodesa.

 
Telegram
  1. Aloita viestiketju käyttäjän @telegrambot:kapsi.fi kanssa
  2. Sano login
  3. Noudata botin antamia ohjeita
  4. Botin pitäisi kutsua sinut viimeisimpiin Telegram-keskusteluihisi. Näyt nyt sillatuissa Telegram-ryhmissä omalla käyttäjälläsi myös Telegram-käyttäjille.
  5. Anna botille halutessasi Matrix-käyttäjäsi access token, jolloin Telegramin kautta lähettämäsi viestit näkyvät Matrix-käyttäjille tulleen Matrix-käyttäjältäsi
    1. Kopioi Matrix access token: Riot (ainakin työpöytä ja selain) -> Settings -> Help & About -> Access Token
    2. Sano botille login-matrix
    3. Anna botille kopioimasi access token
Huomio: Jos kirjautut ulos Riot-instanssista, jonka access tokenia käytät, täytyy vaihe 5 suorittaa uudelleen.
 
Whatsapp
  1. Aloita viestiketju käyttäjän @whatsappbot:kapsi.fi kanssa
  2. Sano login
  3. Skanna koodi puhelimella WhatsApp -> ⋮-> +
  4. Botin pitäisi kutsua sinut viimeisimpiin WhatsApp-keskusteluihisi
  5. Anna botille halutessasi Matrix-käyttäjäsi access token, jolloin Whatsappin kautta lähettämäsi viestit näkyvät Matrix-käyttäjille tulleen Matrix-käyttäjältäsi
    1. Kopioi Matrix access token: Riot (ainakin työpöytä ja selain) -> Settings -> Help & About -> Access Token
    2. Sano botille login-matrix <Access Token>

Huomio: Jos tämän jälkeen käytät Whatsapp Webiä osoitteessa web.whatsapp.com, pitää botille sen jälkeen huutaa "reconnect", mutta miksipä sitä käyttäisit, kun Matrix hoitaa homman :-)
HuomioJos kirjautut ulos Riot-instanssista, jonka access tokenia käytät, täytyy vaihe 5 suorittaa uudelleen.

Facebook

Jos et halua antaa sillalle Facebook-tunnuksiasi, voit käyttää login-komennon tilalla komentoa login-cookie ja seurata botin antamia ohjeita.

  1. Aloita viestiketju käyttäjän @facebookbot:kapsi.fi kanssa
  2. Sano login <sähköpostiosoite> <salasana>
  3. Anna kaksivaiheisen tunnistautumisen koodi, jos sen on käytössä
  4. Botin pitäisi kutsua sinut viimeisimpiin Facebook-keskusteluihisi
  5. Anna botille halutessasi Matrix-käyttäjäsi access token, jolloin Facebookin kautta lähettämäsi viestit näkyvät Matrix-käyttäjille tulleen Matrix-käyttäjältäsi
    1. Kopioi Matrix access token: Riot (ainakin työpöytä ja selain) -> Settings -> Help & About -> Access Token
    2. Sano botille login-matrix <Access Token>

Huomio: Jos kirjautut ulos Riot-instanssista, jonka access tokenia käytät, täytyy vaihe 5 suorittaa uudelleen.

 

Matrix-käyttäjät ja huoneet

Matrixissa käyttäjien tunnukset ovat muodossa @<käyttäjänimi>:<domain.tld> eli esimerkiksi @lyseolainen:lyseo.edu.ouka.fi tai @matrixuser:matrix.org. Samoin huoneiden (kanavien) tunnukset ovat muodossa #<huone>:<domain.tld> Loppuosa kertoo miltä palvelimelta käyttäjä käyttää Matrixia tai millä palvelimella olevaan huoneeseen ollaan yhteydessä. Huoneella voi olla tunnuksia useammalla palvelimella, eli esimerkiksi #matrix:matrix.org on sama kanava kuin #matrixhq:privacytools.io. Huoneeseen yhdistämisen jälkeen ei haittaa vaikka alkuperäinen palvelin lakkaisi olemasta, vaan muut voivat edelleen kommunikoida kanavalla.

 

Copyright huomio

Tämän ohjesivun luomiseksi on hyödynnetty lähdemateriaalina ja kopioitu muutoksin sekä hacklab.fi:n, että Kapsin Matrix-ohjeita alkuperäisten kirjoittajien luvalla. Kiitokst molemmille organisaatioille avusta!