Matrix on uuden polven pikaviestin, jolla pääsee Matrixin omien huoneiden lisäksi myös esimerkiksi IRC-kanaville, Telegramiin ja WhatsAppiin. Lisätietoja Matrixista löytyy esimerkiksi joinmatrix.org-sivustolta.

Suomenkielisiä, syvällisempiä ohjeta löytyy linux.fi wikistä.

Matrix-asiakasohjelmat

Käyttääksesi Matrix-palvelua tarvitset asiakasohjelman, joita löytyy älypuhelimiin, selaimessa toimivana web-sivuna sekä erilaisina työpöytäsovelluksina. Kattava lista erilaisista asiakasohjelmista löytyy Matrix.org -sivustolta . Alla lyhyt lista esimerkkeinä joistain Matrix-asiakasohjelmista.

• Kapsin Element (Selain)
• Element Desktop & Mobile (Linux/MacOS/Windows, Android (Google Play/F-Droid), iOS)

Kirjautuminen Kapsin Matrix-palvelimelle

Käyttäjätunnus

@tunnus:kapsi.fi (Kapsin Elementissä tai jos olet erikseen määrittänyt palvelimen osoitteen riittää pelkkä tunnus)

Salasana

sama kuin shellin ja sähköpostin

Palvelimen osoite (Homeserver URL)

https://matrix.kapsi.fi (Oletus Kapsin Elementissä, pitäisi hakea automaattisesti myös muilla asiakasohjelmilla jos käyttää tunnusta muodossa @tunnus:kapsi.fi)

Matrix-käyttäjät

Matrixissa käyttäjien tunnukset ovat muodossa @<käyttäjänimi>:<domain.tld> eli esimerkiksi @kapsitunnuksesi:kapsi.fi tai @matrixuser:matrix.org. Loppuosa kertoo miltä palvelimelta käyttäjä käyttää Matrixia.

Matrix-huoneet

Huoneella voi olla aliaksia useammalla palvelimella, eli esimerkiksi #matrix:matrix.org on sama huone kuin #matrixhq:privacytools.io. Huoneeseen yhdistämisen jälkeen ei haittaa vaikka jokin palvelin lakkaisi olemasta, vaan muiden palvelinten käyttäjät voivat edelleen kommunikoida kanavalla.

Useat Matrix-asiakasohjelmat tukevat päästä päähän salattua viestintää. Salaukseen liittyvät määritteet ovat huonekohtaisia. Yleensä (ainakin Elementiä käyttäessä) yksityisviestit ja yksityiset huoneet ovat oletusarvoisesti päästä päähän salattuja, mutta julkiset huoneet eivät, jolloin viestit tallentuvat Matrix-palvelimille selkokielisinä.

Mahdollisesti kiinnostavia huoneita

Suomenkieliset julkiset huoneet ovat listattu Matrix Suomi-spacessa. Tähän kannattaa liittyä ja etsiä itseään kiinnostavat huoneet.

Kapsilaisia saattaa kiinnostaa erityisesti:

• Kapsi Matrix: #matrix:kapsi.fi (Tähän huoneeseen kaikki Kapsin Matrix-käyttäjä liittyvät oletusarvoisesti)
• Kapsin virallinen keskustelukanava: #kapsi:kapsi.fi (Sillattu IRCnettiin, Telegramiin, WhatsAppiin sekä Kapsin toimihenkilöiden Slackkiin)
• Yleistä keskustelua enemmän tai vähemmän (yleensä vähemmän) Kapsiin liittyen: #offtopic:kapsi.fi (Sillattu IRCnetin kanavalle #kapsi.fi)
• Keskustelua Matrixista suomeksi: #matrix.fi:kapsi.fi
• Keskustelua Matrixista englanniksi: #matrix:matrix.org

Ohjeita muihin pikaviestinpalveluihin yhdistämiseen

Voit halutessasi yhdistää Matrix-huoneita muihin pikaviestipalveluihin Matrixin viestisiltoja hyödyntäen. Kapsi tarjoaa tällä hetkellä sillat Telegram-, WhatsApp-, Facebook Messenger-, Signal-, Discord- sekä Slack-pikaviestimiin. Näihin siltoihin voi kirjautua omalla käyttäjällä, jolloin sitä voi käytännössä käyttää Matrixin kautta. IRC:n käyttöön voi hyödyntää julkisia siltapalveluita.

Huomaathan, että siltapalveluita käytettäessä välitetyt viestit joudutaan aina käsittelemään selkokielisenä siltapalvelun toimesta. Signalia lukuunottamatta sillatut viestit myös tallentuvat tietokantaan selkokielisenä, Signalin tapauksessa salattuna. Myös Telegram-, WhatsApp- ja Facebook Messenger-sillat tukevat salausta, mutta se ei ole sillatuissa huoneissa oletuksena käytössä. Lisäksi siltapalvelut vaativat toimiakseen palvelukohtaisen kirjautumistunnisteen (access token) tallennuksen, jolloin sillalla on täysi pääsy palvelun käyttäjätiliisi niin kauan kuin olet sisäänkirjautuneena. Kapsin tarjoamat siltapalvelut ovat ylläpidettynä Kapsin järjestelmissä.

IRCnet

1. Yhdistä IRC-kanavalle #_ircnet_<kanavan nimi>:irc.snt.utwente.nl, esimerkiksi #_ircnet_#linux.fi:irc.snt.utwente.nl
2. Toinen vaihtoehto: anna integraatiobotille (@ircnet:irc.snt.utwente.nl) komento !join #kanava
3. Jos haluat tietää nimimerkkisi IRCnetissä, lähetä viesti !nick integraatiobotille @ircnet:irc.snt.utwente.nl ja vaihtaaksesi !nick <haluttu nimimerkki>

libera.chat

1. Yhdistä IRC-kanavalle #<kanavan nimi>:libera.chat, esimekriksi #zfs:libera.chat
2. Jos haluat tietää nimimerkkisi libera.chatissa, lähetä viesti !nick integraatiobotille @appservice:libera.chat ja vaihtaaksesi !nick <haluttu nimimerkki>

Muut IRC-verkot

Lista sillatuista verkoista löytyy osoitteesta https://matrix-org.github.io/matrix-appservice-irc/latest/bridged_networks.html. Asiat toimivat niissä vastaavasti kuin IRCnetissä ja libera.chatissa.

Jos ylläpidät tai haluat ylläpitää Matrixiin sillattua IRC-kanavaa, kannattaa lukea nämä ohjeet linux.fi wikistä.

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.

Jos haluat sillata Matrix-huoneen Telegramiin niin, että myös Matrix-käyttäjät ilman Telegram-tunnuksia voivat liittyä, siihen löytyy ohjeet täältä.

WhatsApp

1. Aloita viestiketju käyttäjän @whatsappbot:kapsi.fi kanssa
2. Sano login
3. Skannaa koodi puhelimella: WhatsApp -> ⋮-> +
4. Botin pitäisi kutsua sinut viimeisimpiin WhatsApp-keskusteluihisi

Huomio! Jos tämän jälkeen kuitenkin käytät WhatsApp Webiä osoitteessa web.whatsapp.com, pitää botille sen jälkeen lähettää viesti "reconnect".

Signal

Jos käytät Signalia jo puhelimella:

1. Aloita viestiketju käyttäjän @signalbot:kapsi.fi kanssa
2. Sano link
3. Skannaa koodi puhelimella: Signal -> Asetukset -> Linkitetyt laitteet -> Lisää laite
4. Botin pitäisi kutsua sinut viimeisimpiin Signal-keskusteluihisi

Jos et käytä Signalia puhelimella:

1. Aloita viestiketju käyttäjän @signalbot:kapsi.fi kanssa
2. Sano register <puhelinnumero>. Jos saat virheen, todennäköisesti täytyy ratkaista captcha:
   1. Captchan ratkaiseminen on tehty sangen vaikeaksi Signalin toimesta. Vähiten vaikeasti homma onnistuu tätä työkalua käyttäen. Captchasta saat pitkän signal-recaptcha -alkuisen merkkipötkön jota tarvitset seuraavassa vaiheessa.
   2. Sano register --captcha signal-recaptcha-v2.6LfBXs0bAAAAAAjkDxxxxxxxx...... <puhelinnumero>
3. Anna botille tekstiviestillä saamasi koodi
4. Botin pitäisi kutsua sinut viimeisimpiin Signal-keskusteluihisi

Facebook

HUOMIO: Nämä ohjeet ovat vanhentuneita Facebookin ja Instagrammin osalta! Vaatii ylläpidolta toimia, että saadaan toimimaan jälleen, mutta mitään aikataulua ei ole antaa. - Skyler Kapsin ja pikaviestimen ylläpidosta, 24.03.2024

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

Discord

(Guild on virallinen termi Discordin "servereille", jotka eivät ole oikeasti palvelimia.)

1. Aloita viestiketju käyttäjän @_discordpuppet_bot:kapsi.fi kanssa
2. Discordiin voi kirjautua joko bottina tai omalla käyttäjällä. Ohjeet molempiin löytyy siltaohjelmiston ohjeista
3. Sano listguilds <link ID (botti sanoi link ID:n kun kirjauduit)>
4. Botti listaa guildit, joiden jäsen olet (tai joiden jäsen Discord-botti on jos kirjauduit botin avulla). Sano bridgeguild <link ID> <guild ID> jokaiselle guildille, jonka haluat sillata.
5. Botti kutsuu sinut huoneisiin, kun niihin tulee uusia viestejä. Voit myös liittyä itse huoneisiin yksi kerrallaan:
   1. Sano listrooms
   2. Klikkaa haluamasi huoneiden linkkejä

Jos haluat sillata kokonaisen kanavan Discordin ja Matrixin välillä, katso ohjeet täältä.

Slack

Huomio! Etenkin ennen työpaikan Slackin siltaamista on syytä varmistaa, että viestien tallentuminen Kapsin palvelimelle on ok.

1. Aloita viestiketju käyttäjän @_slackpuppet_bot:kapsi.fi kanssa
2. Sano link
3. Botti sanoo ERROR, mutta tämä ei ole virhe. Klikkaa botin antamaa linkkiä ja hyväksy pyydetyt luvat
4. Kopioi xoxp-alkuinen token ja sano botille link <kopioimasi token>
5. Botti kutsuu sinut huoneisiin, kun niihin tulee uusia viestejä. Voit myös liittyä itse huoneisiin yksi kerrallaan:
   1. Sano listrooms
   2. Klikkaa haluamasi huoneiden linkkejä

---

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

Pikaviestin.fi ylläpitäjät ovat auttaneet ohjeiden päivittämisessä