Linux.fi - Käyttäjän muokkaukset [fi]

Matrix-Signal

2026-04-13T06:56:29Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, liity kanavalla relaybotin matrix-käyttäjällä ja sano !signal set-relay kanavalla. Jostain syystä automaattinen asetus ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Sano !signal create-group
** Botti vastaa: Successfully created group ainiIxSIcPhGmvkXXXXXXXXXXXXXXXXhqAI=
* Kirjaudu relaybottikäyttäjänä ellet ole jo
* Katso että relaybotilla on riittävä PL (admin, riittääkö moderator..?)
* Sano relaybottikäyttäjänä !signal set-relay
** Botti vastaa "Messages sent by users who haven't logged in will now be relayed through..."

Kutsulinkin saaminen on ratkaisematon mysteeri. Voi vaatia natiiviappiksen käyttöä.
Signal-cli osaa listata olemassaolevat linkit komennolla signal-cli -u +<puhnro> listGroups -d

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2026-04-13T06:56:00Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, liity kanavalla relaybotin matrix-käyttäjällä ja sano !signal set-relay kanavalla. Jostain syystä automaattinen asetus ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Sano !signal create
** Botti vastaa: Successfully created group ainiIxSIcPhGmvkXXXXXXXXXXXXXXXXhqAI=
* Kirjaudu relaybottikäyttäjänä ellet ole jo
* Katso että relaybotilla on riittävä PL (admin, riittääkö moderator..?)
* Sano relaybottikäyttäjänä !signal set-relay
** Botti vastaa "Messages sent by users who haven't logged in will now be relayed through..."

Kutsulinkin saaminen on ratkaisematon mysteeri. Voi vaatia natiiviappiksen käyttöä.
Signal-cli osaa listata olemassaolevat linkit komennolla signal-cli -u +<puhnro> listGroups -d

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2026-04-13T06:55:00Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, liity kanavalla relaybotin matrix-käyttäjällä ja sano !signal set-relay kanavalla. Jostain syystä automaattinen asetus ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Sano !signal create
** Botti vastaa: Successfully created group ainiIxSIcPhGmvkXXXXXXXXXXXXXXXXhqAI=
* Kirjaudu relaybottikäyttäjänä ellet ole jo
* Sano relaybottikäyttäjänä !signal set-relay
** Botti vastaa "Messages sent by users who haven't logged in will now be relayed through..."

Kutsulinkin saaminen on ratkaisematon mysteeri. Voi vaatia natiiviappiksen käyttöä.
Signal-cli osaa listata olemassaolevat linkit komennolla signal-cli -u +<puhnro> listGroups -d

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2026-04-12T18:24:13Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, liity kanavalla relaybotin matrix-käyttäjällä ja sano !signal set-relay kanavalla. Jostain syystä automaattinen asetus ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Sano !signal create
** Botti vastaa: Successfully created group ainiIxSIcPhGmvkXXXXXXXXXXXXXXXXhqAI=

Kutsulinkin saaminen on ratkaisematon mysteeri. Voi vaatia natiiviappiksen käyttöä.
Signal-cli osaa listata olemassaolevat linkit komennolla signal-cli -u +<puhnro> listGroups -d

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Apua

2025-07-25T19:36:36Z

Cos: Lisätty Linux-pikaviestinkanava

Jos sinulla on ylitsepääsemättömiä pulmia, voit kokeilla jotain seuraavista:

*[https://www.linux.fi/w/index.php?search= Etsi tästä wikistä]. [[Aloittelijalle]] on hyvä paikka aloittaa. Katso myös [[Diagnostiikka|diagnosointiohjeet]] ja [[dokumentaatio]]
*Linux.fi:ssä on myös [http://linux.fi/foorumi/ WWW-keskustelualueet]
*Etsi vaikkapa [https://www.google.com/search?-b-d&q=linux Googlen Linux-haulla] neuvoja
*Kysy/hae [http://groups.google.fi/group/sfnet.atk.linux?hl=fi Sfnet.atk.linux-uutisryhmästä]
*Etsi tietoa [[ulkoiset ohjesivustot|ulkoisilta ohjesivustoilta]]
*Liity Linux-aiheiselle pikaviestinkanavalle haluamallasi viestimellä:
**Matrix: [https://matrix.to/#/#linux:hacklab.fi Liity]
**Telegram: [https://t.me/+dw9YmV0cRXVjYTNk Liity]
*Kysele [[IRC]]:stä. Jos olet aloittelija, IRCnetin suomenkielisellä #linux^n00bs -kanavalla ei tarvitse pelätä tyhmiä kysymyksiä; [[Jakelu|jakeluiden]] kanavilta ja foorumeilta löytynee apua jos olet edistyneempi käyttäjä ja sinulle on vaikeampia ongelmia
*Kaupallisia tuen tarjoajia muun muassa [[Linux-yritykset#Tukipalvelut|täältä]], [http://www.coss.fi/ COSS:n yrityshakemistosta] tai [http://wiki.ubuntu-fi.org/Tukipalvelut Ubuntun markkinapaikalta].

== Ohjeita avun pyytämiseen vapaaehtoisilta auttajilta ==
Ennen kuin lähetät kysymyksen, mieti hetki ongelmaa. Mikä ei toimi? Miten se ei toimi? Miten ongelma alkoi? Onko samanaikaisesti ilmennyt muitakin ongelmia?

Mieti asiaa ongelmaa ratkaisevan henkilön näkökulmasta: jos Internet-yhteytesi ei toimi ja kuvailet ongelmasi yksinkertaisesti "Linuxini nettiyhteys ei toimi", ei kukaan osaa antaa ohjeita vaan sinulta on kaivettava paljon lisätietoja. Sen sijaan ongelman tarkempi kuvailu, esimerkiksi:
''"Linuxissani ([[Jakelu|jakelu]] X versio Y) ei toimi Internet-yhteys, sillä verkkokorttini XYZ ei tunnistu. [[Kernel|Ytimen]] versio on 2.6.18. Ongelma alkoi heti jakelun asennuksen jälkeen"''
kertoo jo paljon tarvittavia tietoja, ja sinua voidaan auttaa tehokkaammin.

Ongelman tarkemmassa kuvailussa on muutakin hyötyä. Joudut nimittäin hieman miettimään ongelmaa ja saatat samalla keksiä ratkaisun. Lisäksi osoitat auttajille että sinä ansaitset myös apua.

Tarkemmat ohjeet hyvien kysymysten kysymiseen löydät [http://www.flug.fi/toiminta/linux-ohjeita/kysyminen/ FLUG:in ohjeesta].
[[Luokka:Ohjeet]]

Matrix-IRC

2024-10-04T07:53:09Z

Cos: /* Vaihtoehto: Siltaus JSON-pyynnöllä */

Tarvisiko sillata IRCNet-kanava [[Matrix|Matrixiin]] "paremmalla tavalla" eli plumbaamalla? Plumbaamalla saat kanavalle
admin-oikeudet Matrixin puolelle josta on riemua joissain tilanteissa.

Homma on vähän kimuranttia mutta näillä ohjeilla pitäisi onnistua.

== Ennakkotiedot ==

Tarvitset seuraavat tiedot:

* IRC-siltabotin mxid - IRCNetissä @ircnet:irc.snt.utwente.nl
* Oma mxid - @sina:palvelin.org
* IRC-kanavan nimi - #esimerkki
* IRC-käyttäjän nick, jolla on opit #esimerkki -kanavalla - opin_nick
* Matrix-kanavan id - Alkaa huutomerkillä ja löytyy Element Webistä kanavan asetuksista Advanced | Internal room ID: !paLjOnKirJAimiA:palvelin.fi

== Valmistelu ==

* Luo Matrix-kanava ellei ole jo. ÄLÄ laita päästä päähän-salausta päälle.
* Luo IRC-kanava, ellei ole jo liittymällä siihen. Huolehdi että sinulla (tai avustajallasi) on op-status kanavalla.
* Kutsu IRC-siltabotti Matrix-kanavalle - Matrixissa /invite @ircnet:irc.snt.utwente.nl
* Botti EI liity kanavalle vielä. Voit silti tehdä seuraavan kohdan.
* Aseta IRC-siltabotille riittävät oikeudet Matrixissa (PL99 riittää): /op @ircnet:irc.snt.utwente.nl 99
* Aseta Matrix-kanavalle "Change permissions"-oikeus vaatimaan tason 99, jos haluat että silta voi asettaa IRC-puolen opit moderaattoreiksi.
* JOS IRC-kanava on invite only (+i), kutsu IRC-siltabotti sinne: IRCissä /invite SNTMatrixBot

== Siltaus ==

Työkalu, jolla siltaus onnistuu löytyy sivulta https://l4mrh4x0r.me/plumb-irc/ [https://gitlab.snt.utwente.nl/willemm/plumb-irc (lähdekoodi)]

Anna työkalulle IRC-kanava, Matrix-kanavan ID, IRC-opin nick ja oma Matrix-tunnuksesi. Työkalu sanoo "Link request posted" jos tiedot ovat oikein.

== Vaihtoehto: Siltaus JSON-pyynnöllä ==

Voit vaihtoehtoisesti tehdä siltauspyynnön curlilla jos se tuntuu hauskemmalta tai työkalu ei jostain syystä toimi.

Tee seuraavanlainen curl-komento (kirjoita vaikka tekstieditorissa ja copypastea terminaaliin):

<pre>
curl --location --request POST 'https://matrix-irc.snt.utwente.nl/ircnet/provision/link' --header 'Content-Type: application/json' --data-binary '{
"remote_room_server": "irc.snt.utwente.nl",
"remote_room_channel": "#esimerkki",
"matrix_room_id": "!paLjOnKirJAimiA:palvelin.fi",
"op_nick": "opin_nick",
"user_id": "@sina:palvelin.fi"
}'
</pre>

=== Valmistelu ===

Kutsu siltabotti kanavalle (IRCNetissä @ircnet:irc.snt.utwente.nl)

Anna botille vähintään moderaattorin oikeudet.

Suorita CURL-pyyntö.

=== Vahvistus ===

Siltabotti kysyy nyt opin_nick-käyttäjältä IRC:ssä yksityisviestissä:

<SNTMatrixBot> @sina:palvelin.org has requested to bridge 'Kanavan nimi' (https://matrix.to/#/#kanava:palvelin.org) with #esimerkki on this IRC network. Respond with 'yes' or 'y' to allow, or simply ignore this message to disallow. You have 600 seconds from when this message was sent.

Vastaa: yes

Silta on nyt valmis! Jos on ongelmia, kysele IRCNet-sillan kanavalla #ircnet:utwente.io

=== Lopuksi ===

Tässä vaiheessa on varsinkin uudella kanavalla hyvä varmistaa että kanava on salainen +s ja vain opit voivat vaihtaa topicin +t. Lisäksi
kannattaa asettaa reop-lista +R jotta opit eivat katoa IRCin puolella.
Huomaa että Matrix-sillan luomilla IRCNet-käyttäjillä on uniikki pysyvä IPv6-osoite, eli sitä voi käyttää reop-listalla.

Sano IRC-käyttäjänä:

/mode #esimerkki +st +R *!matrixuuser@2001:xxx:yyy:zzz:0:0:0:xxxx +R *!ircuuseri@palvelin.fi

= Kanavan päivitys =

IRC-silta OSAA seurata kanavapäivitystä. Jos päivität kanavan uuteen versioon, silta tunnistaa sen ja käyttäjät tulevat automaattisesti kanavalle. Tämä tosin tapahtuu vasta kun käyttäjä sanoo jotakin tai silta käynnistetään uudelleen.

= Portaalikanavan muuttaminen plumbatuksi =

Tee näin ja tässä järjestyksessä:
* Hanki opit IRC-kanavalla oikealla IRC-käyttäjällä.
* Perusta uusi Matrix-kanava
* Pura silta (katso kohta Sillan purkaminen)
* Siltaa uusi kanava
* Tee tombstone vanhalle kanavalle osoittamaan uuteen

Huom! Jos et pura siltaa ennen plumbausta, silta jää elämään kahdelle kanavalle eikä sitä saa vanhalta omatoimisesti pois. Tämä lienee bugi IRC-sillassa.

= Sillan purkaminen =

Sillan pitäisi purkautua kun viimeinen Matrix-käyttäjä poistuu kanavalta.

Jos haluat purkaa sillan ja säilyttää Matrix-kanavan, tee seuraavasti (Esimerkki IRCNetissä):

* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Selvitä IRC-kanavan nimi IRC-verkossa
* Varmista että sinulla on op-status IRC-kanavalla.
* Avaa viestiyhteys integraatiobotille (IRCNetissä @ircnet:irc.snt.utwente.nl) ja katso sen kotipalvelin (IRCNetissä irc.snt.utwente.nl)
* Anna komento integraatiobotille:
<pre>
!unlink !kanavanIdJossaPaljonKirjaimia:palvelin.fi irc.snt.utwente.nl #kanava
</pre>

= Heisenbridge =

[https://github.com/hifi/heisenbridge Heisenbridge] on vaihtoehtoinen IRC-silta, jota käytetään joko henkilökohtaisena puppet-siltana tai relaybottina.

Heisenbridgejä EI ole julkisesti käytettävissä, se käytännössä pitää asentaa omalle kotipalvelimelle.

== Relaysillan plumbaus ==

* Lisää kyseessä oleva IRC-verkko Heiseniin
* Luo uusi Matrix-kanava tarvittaessa, ei salausta
* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Sano verkon huoneessa: plumb !kanavanIdJossaPaljonKirjaimia:palvelin.fi #kanava

== Portaali-IRC-kanavan muuttaminen Heisenbridgelle ==

IRC-sillan luomaa portaalikanavaa ei voi epäsillata !unlink-komennolla, vaan täytyy tehdä uusi kanava:

* Perusta uusi Matrix-huone, ei salausta
* Siirrä kaikki muut sillat uuteen huoneeseen
* Kutsu vanhan huoneen Matrix-käyttäjät uuteen huoneeseen (ÄLÄ käytä tombstonea!)
* Poista vanhan huoneen aliakset ja lisää ne uuteen huoneeseen
* Poista vanha huone spaceista joissa se on, lisää uusi tilalle
* Merkkaa vanha huone jotenkin vanhaksi. Vaihda huoneen nimi vaikka Vanha: (Huoneen nimi)
* Plumbaa uusi huone Heisenbridgellä (kts ylempi otsikko)

Huomaa että vanhalle kanavalle pääsee liittymään yhä toisen IRC-sillan kautta. Näin liittyvät käyttävät näkyvät irkkaajina Matrixin kautta.

== Helpotusta irkkaajille ==

Heisenbridge on ns. relaybot, eli sillä on yksi yhteys irkkiin ja se välittää usean käyttäjän viestit tämän yhden botin kautta:

<botti> <kayttaja> Morjensta!

IRC-clientteihin saa skriptejä, joilla botin osuus kadotetaan näkyvistä:

* Irssi: https://github.com/zouppen/irssi-detelexify/
* WeeChat: https://github.com/weechat/weechat/wiki/Triggers#relaybot

[[Luokka:Matrix]]

Matrix-Nextcloud

2023-09-15T07:54:18Z

Cos: Lisätty NC-ohjeraakile

Tässä ohje, muten saadaan Nextcloudista notifikaatiot Matrix-kanavalle

'''ohje raakile ja testaamatta, saa parannella!'''

Matrix: https://github.com/matrix-org/matrix-hookshot

Nextcloudista appi webhooks

Sitten Matrixin hookshot-botin avulla luo uuden webhook linkin (tee huone, kutsu hookshot-bot sinne ja tee siitä ylläpitäjä - kirjoita !hookshot webhook JAWEBHOOKINNIMI)
Hookshot-bot lähettää admin huoneeseen linkin

Nextcloud -> asetukset -> flow -> lisää webhook -> valitse mistä haluat ilmoituksen ja laita se linkki sinne

Huom: Yksi tapahtuma on aina yksi viesti. Eli tietääkseni ei osaa yhdistää, mutta Nextcloudin päässä oli jotain if valikoita joilla saattaa pystyä pelaamaan. Eli siis jos uppaa 200 tiedostoa, floodaa botti kanavalle 200 viestiä. '''tähän olisi hyvä keksiä joku temppu'''

Matrix

2023-09-15T07:48:32Z

Cos: Lisätty NC-linkki

[[Tiedosto:Riot-dark.png|250px|oikea|thumb|Matrixin Element-asiakasohjelma]]

'''Matrix''' on avoin, hajautettu keskusteluprotokolla, jolla voi toteuttaa esimerkiksi Slackin kaltaisen keskustelu- ja ryhmätyöympäristön. Useimmat Matrix-ohjelmistot sekä asiakas- että palvelinpuolella ovat myös vapaaohjelmia. [[Linux.fi:IRC|Linux.fi:n keskustelukanavalle]] pääset myös Matrixia käyttäen. Matrix-keskusteluun liittyminen edellyttää käyttäjätiliä ''kotipalvelimelta'', joka voi olla käyttäjän itse ylläpitämä tai joltain taholta käyttöön saatu.

Matrixiin on iso määrä erilaisia asiakasohjelmia erilaisiin käyttötarkoituksiin. Referenssitoteutus on nimeltään '''[[Element]]''' ja siitä on versiot selaimille, macOS:lle, Windowsille, Linuxille, Androidille ja iOS:lle. Eri asiakasohjelmia on helppo kokeilla ja lista ohjelmista löytyy [https://matrix.org/clients/ täältä].

== Suomalaisia Matrix-palvelimia ==

Matrixissa voit valita mille palvelimelle teet tunnuksesi, aivan kuten sähköpostiosoitetta hankkiessa.

Voit tehdä tunnuksen kaikille avoimelle matrix.org -palvelimelle osoitteessa https://app.element.io/#/register

Matrix.org on kuitenkin usein valtavan käyttäjämääränsä vuoksi ruuhkainen joten on suositeltavaa tehdä tunnus jollekin muulle palvelimelle, jos vaan mahdollista.

Tässä muutama suomalainen palvelin, joille on mahdollista hankkia tunnus:

* https://www.pikaviestin.fi/ - '''Kaikille suomalaisille avoin palvelin'''. Vaatii suomalaisen sähköposti-osoitteen tai pyynnön sähköpostitse. Tekniset resurssit tarjoaa Kapsi Ry.
* https://www.kapsi.fi/palvelut/matrix.html - Kapsi ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://matrix.hacklab.fi/ - Hacklab.fi ry:n palvelin, vaatii jäsenyyden jossain suomen hacklabissa
* https://element.freemail.fi/ - Braene Oy:n ylläpitämä palvelin. Vaatii käyttäjätunnuksen freemail.fi-sähköpostipalvelussa [https://freemail.fi]

Epävirallinen lista avoimista palvelimista löytyy [https://joinmatrix.org/servers/ täältä].

Jos ehdit jo tehdä tunnuksen matrix.org:iin, voit [https://ems.element.io/tools/matrix-migration tällä työkalulla] siirtää tietosi uudelle palvelimelle.

Oman Matrix-kotipalvelimen ylläpitäminen on myös kohtuullisen helppoa ja vertautuu muiden palvelinten pyörittämiseen.

== Suomenkielisiä Matrix-huoneita ==

Matrixissa space tarkoittaa joukkoa huoneita. Niiden avulla voidaan ryhmitellä huoneita esimerkiksi aihepiireittäin ja helpottaa kanavien löytämistä.

Lista tunnetuista avoimet suomenkielisistä huoneista on kerätty [https://matrix.to/#/!WDaMZSVinTZRLOTajM:hacklab.fi?via=hacklab.fi&via=matrix.org&via=kapsi.fi Matrix Suomi] -spaceen.

Huoneisiin pääset helposti kun liityt kyseiseen spaceen jolloin näet listan kanavista.

Voit liittyä spaceen klikkaamalla ylläolevaa linkkiä tai kirjoittamalla '''/join #matrix-suomi:kapsi.fi'''. Jos tiedät huoneen joka puuttuu, pyydä ylläpitäjiä
lisäämään se [https://matrix.to/#/#matrix.fi:matrix.org Matrix.fi-huoneessa]. Kyseisessä huoneessa saat myös vertaistukea Matrixin käyttöön.

Jos tiedät IRC-kanavan jolle haluat liittyä, liity huoneeseen '''#_ircnet_#kanava:irc.snt.utwente.nl''' (IRCNet) tai '''#kanava:libera.chat'''
(libera.chat). Lista kaikista sillatuista verkoista löytyy [https://matrix-org.github.io/matrix-appservice-irc/latest/bridged_networks.html täältä].

Suuri osa suomenkielisistä Matrix-huoneista on sillattu vastaavalle IRC-kanavalle.

== Muun kielisiä vapaaohjelma-aiheisia huoneita ==

* #fosdem:fosdem.org - [[FOSDEM]]-konferenssin pääasiallinen keskusteluhuone
* #revision:hacklab.fi - [https://revision-party.net/ Revision-demopartyt]

== Ohjeita ==

* [[Matrix-IRC|Matrix-IRC-siltaus]]
* [[Matrix-Telegram|Matrix-Telegram-siltaus]]
* [[Matrix-Discord|Matrix-Discord-siltaus]]
* [[Matrix-Signal|Matrix-Signal-siltaus]]
* [[Matrix-Nextcloud|Nextcloud- notifikaatiot Matrixiin]]

== Katso myös ==

* [https://matrix.org Matrixin verkkosivut ]
* [https://app.element.io/ Elementin, web-pohjaisen Matrix-asiakasohjelman, kirjautumissivu]
* [https://odysee.com/@Luke:7/matrix-vs.-xmpp-which-is-better-for:9 Luke Smithin video Matrix- sekä XMPP-protokollien heikkouksista ja vahvuuksista]
* [https://www.youtube.com/watch?v=v5Y8zCwIxjI Noordstar Legacyn video Matrixin olemuksesta selitettynä säilykepurkeilla ja narulla]

[[Luokka:Pikaviestimet]]
[[Luokka:Verkko]]
[[Luokka:Matrix]]

Matrix-Discord

2023-09-08T11:36:14Z

Cos: /* Yksittäisen kanavan siltaus */

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

= t2bot.io -palvelun avulla =

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Mautrix-discord =

Sillalle on suht hyvät ohjeet [https://docs.mau.fi/bridges/go/discord/index.html täällä].

== Kokonaisen kanavan siltaaminen (relaybot-toiminto) ==

Lue ohjeet "relaying with webhooks"-kohdasta. Suosittelen tekemään oman Matrix-tunnuksen välitysbotille, jolla siltausta hallitaan. Kutsutaan tässä ohjeessa
sitä nimellä relaybot.

=== Valmistelut ===

* Ota silta käyttöön. Sillan komentobottia kutsutaan tässä ohjeessa discordbot-nimellä.
* Tee discordbotti ohjeiden mukaan ja kutsu se Discord-kiltaan. Anna ohjeiden neuvomat oikeudet.
* Autentikoidu webhookeilla discordiin (tee relaybot-tunnuksella)

=== Yksittäisen kanavan siltaus ===

* Jos kanavalla on jo vanha Discord-silta, aja se alas (tai tulee karmea ikikiersiö)
* Liity relaybotilla kanavalle, anna relaybotille Administrator-oikeudet
* Kutsu discordbot kanavalle (ei vaadi oikeuksia)
* Selvitä discord-kanavan id. Saa selville discordin käyttöliittymästä jos ei muuten.
* Sano relaybottina !discord bridge <kanavaid>
* Discordin pitäisi nyt siltautua
* Määrittele relaybot-toiminto kanavalle: Sano relaybottina !discord set-relay --create Matrix
* Voit laskea relaybotin oikeustasoa alemmaksi jos haluat
* Voit myös poistua relaybotilla kanavalta, mutta (tällä hetkellä) se kutsutaan sinne takaisin kun silta käynnistetään uudestaan.

= mx-puppet-discord (Vanhentunut silta jota ei kehitetä, älä käytä) =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Sillan asennus ja konfigurointi ==

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Ennen kanavien siltausta täytyy sillata kilta.

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

== Huoneen päivitys ==

Tämä Discord-silta EI osaa ainakaan toistaisemsi seurata huonepäivityksiä (room upgrade). Jos päivität huoneen, tee seuraavasti:

* Botin komentohuoneessa epäsiltaa k.o huone: unbridge 3 87xxxxxxxxx91
* Päivitä huone (ei haittaa jos se on jo päivitetty)
* Kutsu siltabotti uuteen huoneeseen
* Siltaa uudestaan, huoneessa: !discord bridge 3 87xxxxxxxxx91

Numero 3 on esimerkissä puppet id ja 87xxxxxxxxx91 kanavan id discordista.

== Yleisiä ongelmia ==

=== Discordin puolelle viestit tulevat "laatikoissa" ===

* Varmista että Discord-admin antoi botin vaatimat oikeudet
* Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
* Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.

[[Luokka:Matrix]]

Matrix-Discord

2023-09-08T10:15:21Z

Cos: /* Kokonaisen kanavan siltaaminen (relaybot-toiminto) */

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

= t2bot.io -palvelun avulla =

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Mautrix-discord =

Sillalle on suht hyvät ohjeet [https://docs.mau.fi/bridges/go/discord/index.html täällä].

== Kokonaisen kanavan siltaaminen (relaybot-toiminto) ==

Lue ohjeet "relaying with webhooks"-kohdasta. Suosittelen tekemään oman Matrix-tunnuksen välitysbotille, jolla siltausta hallitaan. Kutsutaan tässä ohjeessa
sitä nimellä relaybot.

=== Valmistelut ===

* Ota silta käyttöön. Sillan komentobottia kutsutaan tässä ohjeessa discordbot-nimellä.
* Tee discordbotti ohjeiden mukaan ja kutsu se Discord-kiltaan. Anna ohjeiden neuvomat oikeudet.
* Autentikoidu webhookeilla discordiin (tee relaybot-tunnuksella)

=== Yksittäisen kanavan siltaus ===

* Jos kanavalla on jo vanha Discord-silta, aja se alas (tai tulee karmea ikikiersiö)
* Liity relaybotilla kanavalle, anna relaybotille Administrator-oikeudet
* Kutsu discordbot kanavalle (ei vaadi oikeuksia)
* Selvitä discord-kanavan id. Saa selville discordin käyttöliittymästä jos ei muuten.
* Sano relaybottina !discord bridge <kanavaid>
* Discordin pitäisi nyt siltautua
* Määrittele relaybot-toiminto kanavalle: Sano relaybottina !discord set-relay --create Matrix
* Voit laskea relaybotin oikeustasoa alemmaksi jos haluat

= mx-puppet-discord (Vanhentunut silta jota ei kehitetä, älä käytä) =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Sillan asennus ja konfigurointi ==

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Ennen kanavien siltausta täytyy sillata kilta.

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

== Huoneen päivitys ==

Tämä Discord-silta EI osaa ainakaan toistaisemsi seurata huonepäivityksiä (room upgrade). Jos päivität huoneen, tee seuraavasti:

* Botin komentohuoneessa epäsiltaa k.o huone: unbridge 3 87xxxxxxxxx91
* Päivitä huone (ei haittaa jos se on jo päivitetty)
* Kutsu siltabotti uuteen huoneeseen
* Siltaa uudestaan, huoneessa: !discord bridge 3 87xxxxxxxxx91

Numero 3 on esimerkissä puppet id ja 87xxxxxxxxx91 kanavan id discordista.

== Yleisiä ongelmia ==

=== Discordin puolelle viestit tulevat "laatikoissa" ===

* Varmista että Discord-admin antoi botin vaatimat oikeudet
* Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
* Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.

[[Luokka:Matrix]]

Matrix-Discord

2023-09-08T08:16:34Z

Cos: Lisätty ohje Mautrix-Discord-sillalle

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

= t2bot.io -palvelun avulla =

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Mautrix-discord =

Sillalle on suht hyvät ohjeet [https://docs.mau.fi/bridges/go/discord/index.html täällä].

== Kokonaisen kanavan siltaaminen (relaybot-toiminto) ==

Lue ohjeet "relaying with webhooks"-kohdasta. Suosittelen tekemään oman Matrix-tunnuksen välitysbotille, jolla siltausta hallitaan. Kutsutaan tässä ohjeessa
sitä nimellä relaybot.

=== Valmistelut ===

* Ota silta käyttöön. Sillan komentobottia kutsutaan tässä ohjeessa discordbot-nimellä.
* Tee discordbotti ohjeiden mukaan ja kutsu se Discord-kiltaan. Anna ohjeiden neuvomat oikeudet.
* Autentikoidu webhookeilla discordiin (tee relaybot-tunnuksella)

=== Yksittäisen kanavan siltaus ===

* Liity relaybotilla kanavalle, anna relaybotille Administrator-oikeudet
* Kutsu discordbot kanavalle (ei vaadi oikeuksia)
* Selvitä discord-kanavan id. Saa selville discordin käyttöliittymästä jos ei muuten.
* Sano relaybottina !discord bridge <kanavaid>
* Discordin pitäisi nyt siltautua
* Määrittele relaybot-toiminto kanavalle: Sano relaybottina !discord set-relay --create Matrix
* Voit laskea relaybotin oikeustasoa alemmaksi jos haluat

= mx-puppet-discord (Vanhentunut silta jota ei kehitetä, älä käytä) =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Sillan asennus ja konfigurointi ==

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Ennen kanavien siltausta täytyy sillata kilta.

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

== Huoneen päivitys ==

Tämä Discord-silta EI osaa ainakaan toistaisemsi seurata huonepäivityksiä (room upgrade). Jos päivität huoneen, tee seuraavasti:

* Botin komentohuoneessa epäsiltaa k.o huone: unbridge 3 87xxxxxxxxx91
* Päivitä huone (ei haittaa jos se on jo päivitetty)
* Kutsu siltabotti uuteen huoneeseen
* Siltaa uudestaan, huoneessa: !discord bridge 3 87xxxxxxxxx91

Numero 3 on esimerkissä puppet id ja 87xxxxxxxxx91 kanavan id discordista.

== Yleisiä ongelmia ==

=== Discordin puolelle viestit tulevat "laatikoissa" ===

* Varmista että Discord-admin antoi botin vaatimat oikeudet
* Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
* Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.

[[Luokka:Matrix]]

Matrix-Signal

2023-06-01T18:03:31Z

Cos: /* Jos omistat sillan */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, liity kanavalla relaybotin matrix-käyttäjällä ja sano !signal set-relay kanavalla. Jostain syystä automaattinen asetus ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa linkillä, jos huone on julkinen.

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2023-05-30T13:59:26Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, sano !signal set-relay kanavalla. Jostain syystä tämä ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa linkillä, jos huone on julkinen.

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2023-05-25T12:04:00Z

Cos: Siltaus todettu toimivaksi, otin pois huomautuksen ratkaisemattomista ongelmista

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja [[wikipedia:fi:Signal|Signal]]in välillä.

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, sano !signal set-relay kanavalla. Jostain syystä tämä ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa linkillä, jos huone on julkinen.

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2023-03-14T20:30:09Z

Cos: /* Sillan valmistelu relaybottia varten */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja Signalin välillä.

'''HUOM: Signal-sillan kanssa on vielä ratkaisemattomia ongelmia, joten sivun sisältö ei välttämättä toimi'''

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin
muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

=== Jos omistat sillan ===

* Aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Lisää permissions-kohtaan "*": "relay"
* Varmista että relay.enabled on true

'''Huom: Jos relaybot-määrityksestä huolimatta silta ei välitä viestejä, sano !signal set-relay kanavalla. Jostain syystä tämä ei toiminut.'''

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa linkillä, jos huone on julkinen.

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2023-03-14T19:49:35Z

Cos: Kaikenlaisia päivityksiä

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja Signalin välillä.

'''HUOM: Signal-sillan kanssa on vielä ratkaisemattomia ongelmia, joten sivun sisältö ei välttämättä toimi'''

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin
muulle numerolle ja kirjautua sillä siltaan.

== Sillan valmistelu relaybottia varten ==

Jos haluat sillata minkä vaan Matrix-kanavan etkä vain henkilökohtaisia, tarvitset relaybotin joka välittää viestit Signaliin.
Relaybotti tarvitsee oikean puhelinnumeron ja Signal-tunnuksen.

* Luo Matrix-tunnus relaybottia varten, kirjaudu tällä tunnuksella sisään
* Kirjaudu Signaliin relaybotilla
* Konfiguroi "double puppeting" jotta silta pystyy käyttämään Matrix-tiliä. Ohje: https://docs.mau.fi/bridges/general/double-puppeting.html#manually
* Jos omistat sillan, aseta relaybotin mxid sillan konffitiedostoon bridge.relay.relaybot:ksi. Tällöin sitä käytetään automattisesti relaynä.
* Jos et omista siltaa, sano siltauksen jälkeen kanavilla relaybotin tunnuksilla !signal set-relay

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa linkillä, jos huone on julkinen.

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Selvitä Signal-kanaan id
* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille PL 51
* Sano !signal bridge <kanavan id>
* Silta vastaa That Signal chat has no existing portal. To confirm bridging the chat to this room, use !signal continue
* Sano !signal continue

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2023-03-13T17:47:03Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja Signalin välillä.

'''HUOM: Signal-sillan kanssa on vielä ratkaisemattomia ongelmia, joten sivun sisältö on vielä tynkä'''

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sillä
siltaan.

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille moderaattorioikeudet
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Sano !signal set-relay
** Botti vastaa: Messages from non-logged-in users in this room will now be bridged through your Signal account.
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa linkillä, jos huone on julkinen.

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi

'''HUOM: Tämä ei liene mahdollista ainakaan botin komennoilla? Onnistuisiko tietokantamuutoksella kuten WhatsApp-sillassa'''

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-IRC

2022-09-14T13:43:14Z

Cos: /* Siltaus */ Lisätty lähdekoodilinkki

Tarvisiko sillata IRCNet-kanava [[Matrix|Matrixiin]] "paremmalla tavalla" eli plumbaamalla? Plumbaamalla saat kanavalle
admin-oikeudet Matrixin puolelle josta on riemua joissain tilanteissa.

Homma on vähän kimuranttia mutta näillä ohjeilla pitäisi onnistua.

== Ennakkotiedot ==

Tarvitset seuraavat tiedot:

* IRC-siltabotin mxid - IRCNetissä @ircnet:irc.snt.utwente.nl
* Oma mxid - @sina:palvelin.org
* IRC-kanavan nimi - #esimerkki
* IRC-käyttäjän nick, jolla on opit #esimerkki -kanavalla - opin_nick
* Matrix-kanavan id - Alkaa huutomerkillä ja löytyy Element Webistä kanavan asetuksista Advanced | Internal room ID: !paLjOnKirJAimiA:palvelin.fi

== Valmistelu ==

* Luo Matrix-kanava ellei ole jo. ÄLÄ laita päästä päähän-salausta päälle.
* Luo IRC-kanava, ellei ole jo liittymällä siihen. Huolehdi että sinulla (tai avustajallasi) on op-status kanavalla.
* Kutsu IRC-siltabotti Matrix-kanavalle - Matrixissa /invite @ircnet:irc.snt.utwente.nl
* Botti EI liity kanavalle vielä. Voit silti tehdä seuraavan kohdan.
* Aseta IRC-siltabotille riittävät oikeudet Matrixissa (PL99 riittää): /op @ircnet:irc.snt.utwente.nl 99
* Aseta Matrix-kanavalle "Change permissions"-oikeus vaatimaan tason 99, jos haluat että silta voi asettaa IRC-puolen opit moderaattoreiksi.
* JOS IRC-kanava on invite only (+i), kutsu IRC-siltabotti sinne: IRCissä /invite SNTMatrixBot

== Siltaus ==

Työkalu, jolla siltaus onnistuu löytyy sivulta https://l4mrh4x0r.me/plumb-irc/ [https://gitlab.snt.utwente.nl/willemm/plumb-irc (lähdekoodi)]

Anna työkalulle IRC-kanava, Matrix-kanavan ID, IRC-opin nick ja oma Matrix-tunnuksesi. Työkalu sanoo "Link request posted" jos tiedot ovat oikein.

== Vaihtoehto: Siltaus JSON-pyynnöllä ==

Voit vaihtoehtoisesti tehdä siltauspyynnön curlilla jos se tuntuu hauskemmalta tai työkalu ei jostain syystä toimi.

Tee seuraavanlainen curl-komento (kirjoita vaikka tekstieditorissa ja copypastea terminaaliin):

<pre>
curl --location --request POST 'https://matrix-irc.snt.utwente.nl/ircnet/provision/link' --header 'Content-Type: application/json' --data-binary '{
"remote_room_server": "irc.snt.utwente.nl",
"remote_room_channel": "#esimerkki",
"matrix_room_id": "!paLjOnKirJAimiA:palvelin.fi",
"op_nick": "opin_nick",
"user_id": "@sina:palvelin.org"
}'
</pre>

=== Vahvistus ===

Siltabotti kysyy nyt opin_nick-käyttäjältä IRC:ssä yksityisviestissä:

<SNTMatrixBot> @sina:palvelin.org has requested to bridge 'Kanavan nimi' (https://matrix.to/#/#kanava:palvelin.org) with #esimerkki on this IRC network. Respond with 'yes' or 'y' to allow, or simply ignore this message to disallow. You have 600 seconds from when this message was sent.

Vastaa: yes

Silta on nyt valmis! Jos on ongelmia, kysele IRCNet-sillan kanavalla #ircnet:utwente.io

=== Lopuksi ===

Tässä vaiheessa on varsinkin uudella kanavalla hyvä varmistaa että kanava on salainen +s ja vain opit voivat vaihtaa topicin +t. Lisäksi
kannattaa asettaa reop-lista +R jotta opit eivat katoa IRCin puolella.
Huomaa että Matrix-sillan luomilla IRCNet-käyttäjillä on uniikki pysyvä IPv6-osoite, eli sitä voi käyttää reop-listalla.

Sano IRC-käyttäjänä:

/mode #esimerkki +st +R *!matrixuuser@2001:xxx:yyy:zzz:0:0:0:xxxx +R *!ircuuseri@palvelin.fi

= Kanavan päivitys =

IRC-silta OSAA seurata kanavapäivitystä. Jos päivität kanavan uuteen versioon, silta tunnistaa sen ja käyttäjät tulevat automaattisesti kanavalle. Tämä tosin tapahtuu vasta kun käyttäjä sanoo jotakin tai silta käynnistetään uudelleen.

= Portaalikanavan muuttaminen plumbatuksi =

Tee näin ja tässä järjestyksessä:
* Hanki opit IRC-kanavalla oikealla IRC-käyttäjällä.
* Perusta uusi Matrix-kanava
* Pura silta (katso kohta Sillan purkaminen)
* Siltaa uusi kanava
* Tee tombstone vanhalle kanavalle osoittamaan uuteen

Huom! Jos et pura siltaa ennen plumbausta, silta jää elämään kahdelle kanavalle eikä sitä saa vanhalta omatoimisesti pois. Tämä lienee bugi IRC-sillassa.

= Sillan purkaminen =

Sillan pitäisi purkautua kun viimeinen Matrix-käyttäjä poistuu kanavalta.

Jos haluat purkaa sillan ja säilyttää Matrix-kanavan, tee seuraavasti (Esimerkki IRCNetissä):

* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Selvitä IRC-kanavan nimi IRC-verkossa
* Varmista että sinulla on op-status IRC-kanavalla.
* Avaa viestiyhteys integraatiobotille (IRCNetissä @ircnet:irc.snt.utwente.nl) ja katso sen kotipalvelin (IRCNetissä irc.snt.utwente.nl)
* Anna komento integraatiobotille:
<pre>
!unlink !kanavanIdJossaPaljonKirjaimia:palvelin.fi irc.snt.utwente.nl #kanava
</pre>

= Heisenbridge =

[https://github.com/hifi/heisenbridge Heisenbridge] on vaihtoehtoinen IRC-silta, jota käytetään joko henkilökohtaisena puppet-siltana tai relaybottina.

Heisenbridgejä EI ole julkisesti käytettävissä, se käytännössä pitää asentaa omalle kotipalvelimelle.

== Relaysillan plumbaus ==

* Lisää kyseessä oleva IRC-verkko Heiseniin
* Luo uusi Matrix-kanava tarvittaessa, ei salausta
* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Sano verkon huoneessa: plumb !kanavanIdJossaPaljonKirjaimia:palvelin.fi #kanava

== Portaali-IRC-kanavan muuttaminen Heisenbridgelle ==

IRC-sillan luomaa portaalikanavaa ei voi epäsillata !unlink-komennolla, vaan täytyy tehdä uusi kanava:

* Perusta uusi Matrix-huone, ei salausta
* Siirrä kaikki muut sillat uuteen huoneeseen
* Kutsu vanhan huoneen Matrix-käyttäjät uuteen huoneeseen (ÄLÄ käytä tombstonea!)
* Poista vanhan huoneen aliakset ja lisää ne uuteen huoneeseen
* Poista vanha huone spaceista joissa se on, lisää uusi tilalle
* Merkkaa vanha huone jotenkin vanhaksi. Vaihda huoneen nimi vaikka Vanha: (Huoneen nimi)
* Plumbaa uusi huone Heisenbridgellä (kts ylempi otsikko)

Huomaa että vanhalle kanavalle pääsee liittymään yhä toisen IRC-sillan kautta. Näin liittyvät käyttävät näkyvät irkkaajina Matrixin kautta.

== Helpotusta irkkaajille ==

Heisenbridge on ns. relaybot, eli sillä on yksi yhteys irkkiin ja se välittää usean käyttäjän viestit tämän yhden botin kautta:

<botti> <kayttaja> Morjensta!

IRC-clientteihin saa skriptejä, joilla botin osuus kadotetaan näkyvistä:

* Irssi: https://github.com/zouppen/irssi-detelexify/
* WeeChat: https://github.com/weechat/weechat/wiki/Triggers#relaybot

[[Luokka:Matrix]]

Matrix-IRC

2022-09-14T10:39:18Z

Cos: Lisätty siltaustyökalu

Tarvisiko sillata IRCNet-kanava [[Matrix|Matrixiin]] "paremmalla tavalla" eli plumbaamalla? Plumbaamalla saat kanavalle
admin-oikeudet Matrixin puolelle josta on riemua joissain tilanteissa.

Homma on vähän kimuranttia mutta näillä ohjeilla pitäisi onnistua.

== Ennakkotiedot ==

Tarvitset seuraavat tiedot:

* IRC-siltabotin mxid - IRCNetissä @ircnet:irc.snt.utwente.nl
* Oma mxid - @sina:palvelin.org
* IRC-kanavan nimi - #esimerkki
* IRC-käyttäjän nick, jolla on opit #esimerkki -kanavalla - opin_nick
* Matrix-kanavan id - Alkaa huutomerkillä ja löytyy Element Webistä kanavan asetuksista Advanced | Internal room ID: !paLjOnKirJAimiA:palvelin.fi

== Valmistelu ==

* Luo Matrix-kanava ellei ole jo. ÄLÄ laita päästä päähän-salausta päälle.
* Luo IRC-kanava, ellei ole jo liittymällä siihen. Huolehdi että sinulla (tai avustajallasi) on op-status kanavalla.
* Kutsu IRC-siltabotti Matrix-kanavalle - Matrixissa /invite @ircnet:irc.snt.utwente.nl
* Botti EI liity kanavalle vielä. Voit silti tehdä seuraavan kohdan.
* Aseta IRC-siltabotille riittävät oikeudet Matrixissa (PL99 riittää): /op @ircnet:irc.snt.utwente.nl 99
* Aseta Matrix-kanavalle "Change permissions"-oikeus vaatimaan tason 99, jos haluat että silta voi asettaa IRC-puolen opit moderaattoreiksi.
* JOS IRC-kanava on invite only (+i), kutsu IRC-siltabotti sinne: IRCissä /invite SNTMatrixBot

== Siltaus ==

Työkalu, jolla siltaus onnistuu löytyy sivulta https://l4mrh4x0r.me/plumb-irc/

Anna työkalulle IRC-kanava, Matrix-kanavan ID, IRC-opin nick ja oma Matrix-tunnuksesi. Työkalu sanoo "Link request posted" jos tiedot ovat oikein.

== Vaihtoehto: Siltaus JSON-pyynnöllä ==

Voit vaihtoehtoisesti tehdä siltauspyynnön curlilla jos se tuntuu hauskemmalta tai työkalu ei jostain syystä toimi.

Tee seuraavanlainen curl-komento (kirjoita vaikka tekstieditorissa ja copypastea terminaaliin):

<pre>
curl --location --request POST 'https://matrix-irc.snt.utwente.nl/ircnet/provision/link' --header 'Content-Type: application/json' --data-binary '{
"remote_room_server": "irc.snt.utwente.nl",
"remote_room_channel": "#esimerkki",
"matrix_room_id": "!paLjOnKirJAimiA:palvelin.fi",
"op_nick": "opin_nick",
"user_id": "@sina:palvelin.org"
}'
</pre>

=== Vahvistus ===

Siltabotti kysyy nyt opin_nick-käyttäjältä IRC:ssä yksityisviestissä:

<SNTMatrixBot> @sina:palvelin.org has requested to bridge 'Kanavan nimi' (https://matrix.to/#/#kanava:palvelin.org) with #esimerkki on this IRC network. Respond with 'yes' or 'y' to allow, or simply ignore this message to disallow. You have 600 seconds from when this message was sent.

Vastaa: yes

Silta on nyt valmis! Jos on ongelmia, kysele IRCNet-sillan kanavalla #ircnet:utwente.io

=== Lopuksi ===

Tässä vaiheessa on varsinkin uudella kanavalla hyvä varmistaa että kanava on salainen +s ja vain opit voivat vaihtaa topicin +t. Lisäksi
kannattaa asettaa reop-lista +R jotta opit eivat katoa IRCin puolella.
Huomaa että Matrix-sillan luomilla IRCNet-käyttäjillä on uniikki pysyvä IPv6-osoite, eli sitä voi käyttää reop-listalla.

Sano IRC-käyttäjänä:

/mode #esimerkki +st +R *!matrixuuser@2001:xxx:yyy:zzz:0:0:0:xxxx +R *!ircuuseri@palvelin.fi

= Kanavan päivitys =

IRC-silta OSAA seurata kanavapäivitystä. Jos päivität kanavan uuteen versioon, silta tunnistaa sen ja käyttäjät tulevat automaattisesti kanavalle. Tämä tosin tapahtuu vasta kun käyttäjä sanoo jotakin tai silta käynnistetään uudelleen.

= Portaalikanavan muuttaminen plumbatuksi =

Tee näin ja tässä järjestyksessä:
* Hanki opit IRC-kanavalla oikealla IRC-käyttäjällä.
* Perusta uusi Matrix-kanava
* Pura silta (katso kohta Sillan purkaminen)
* Siltaa uusi kanava
* Tee tombstone vanhalle kanavalle osoittamaan uuteen

Huom! Jos et pura siltaa ennen plumbausta, silta jää elämään kahdelle kanavalle eikä sitä saa vanhalta omatoimisesti pois. Tämä lienee bugi IRC-sillassa.

= Sillan purkaminen =

Sillan pitäisi purkautua kun viimeinen Matrix-käyttäjä poistuu kanavalta.

Jos haluat purkaa sillan ja säilyttää Matrix-kanavan, tee seuraavasti (Esimerkki IRCNetissä):

* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Selvitä IRC-kanavan nimi IRC-verkossa
* Varmista että sinulla on op-status IRC-kanavalla.
* Avaa viestiyhteys integraatiobotille (IRCNetissä @ircnet:irc.snt.utwente.nl) ja katso sen kotipalvelin (IRCNetissä irc.snt.utwente.nl)
* Anna komento integraatiobotille:
<pre>
!unlink !kanavanIdJossaPaljonKirjaimia:palvelin.fi irc.snt.utwente.nl #kanava
</pre>

= Heisenbridge =

[https://github.com/hifi/heisenbridge Heisenbridge] on vaihtoehtoinen IRC-silta, jota käytetään joko henkilökohtaisena puppet-siltana tai relaybottina.

Heisenbridgejä EI ole julkisesti käytettävissä, se käytännössä pitää asentaa omalle kotipalvelimelle.

== Relaysillan plumbaus ==

* Lisää kyseessä oleva IRC-verkko Heiseniin
* Luo uusi Matrix-kanava tarvittaessa, ei salausta
* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Sano verkon huoneessa: plumb !kanavanIdJossaPaljonKirjaimia:palvelin.fi #kanava

== Portaali-IRC-kanavan muuttaminen Heisenbridgelle ==

IRC-sillan luomaa portaalikanavaa ei voi epäsillata !unlink-komennolla, vaan täytyy tehdä uusi kanava:

* Perusta uusi Matrix-huone, ei salausta
* Siirrä kaikki muut sillat uuteen huoneeseen
* Kutsu vanhan huoneen Matrix-käyttäjät uuteen huoneeseen (ÄLÄ käytä tombstonea!)
* Poista vanhan huoneen aliakset ja lisää ne uuteen huoneeseen
* Poista vanha huone spaceista joissa se on, lisää uusi tilalle
* Merkkaa vanha huone jotenkin vanhaksi. Vaihda huoneen nimi vaikka Vanha: (Huoneen nimi)
* Plumbaa uusi huone Heisenbridgellä (kts ylempi otsikko)

Huomaa että vanhalle kanavalle pääsee liittymään yhä toisen IRC-sillan kautta. Näin liittyvät käyttävät näkyvät irkkaajina Matrixin kautta.

== Helpotusta irkkaajille ==

Heisenbridge on ns. relaybot, eli sillä on yksi yhteys irkkiin ja se välittää usean käyttäjän viestit tämän yhden botin kautta:

<botti> <kayttaja> Morjensta!

IRC-clientteihin saa skriptejä, joilla botin osuus kadotetaan näkyvistä:

* Irssi: https://github.com/zouppen/irssi-detelexify/
* WeeChat: https://github.com/weechat/weechat/wiki/Triggers#relaybot

[[Luokka:Matrix]]

Matrix-IRC

2022-08-18T14:29:08Z

Cos: Heisenbridge-ohje

Tarvisiko sillata IRCNet-kanava [[Matrix|Matrixiin]] "paremmalla tavalla" eli plumbaamalla? Plumbaamalla saat kanavalle
admin-oikeudet Matrixin puolelle josta on riemua joissain tilanteissa.

Homma on vähän kimuranttia mutta näillä ohjeilla pitäisi onnistua.

== Ennakkotiedot ==

Tarvitset seuraavat tiedot:

* IRC-siltabotin mxid - IRCNetissä @ircnet:irc.snt.utwente.nl
* Oma mxid - @sina:palvelin.org
* IRC-kanavan nimi - #esimerkki
* IRC-käyttäjän nick, jolla on opit #esimerkki -kanavalla - opin_nick
* Matrix-kanavan id - Alkaa huutomerkillä ja löytyy Element Webistä kanavan asetuksista Advanced | Internal room ID: !paLjOnKirJAimiA:palvelin.fi

== Valmistelu ==

* Luo Matrix-kanava ellei ole jo. ÄLÄ laita päästä päähän-salausta päälle.
* Luo IRC-kanava, ellei ole jo liittymällä siihen. Huolehdi että sinulla (tai avustajallasi) on op-status kanavalla.
* Kutsu IRC-siltabotti Matrix-kanavalle - Matrixissa /invite @ircnet:irc.snt.utwente.nl
* Botti EI liity kanavalle vielä. Voit silti tehdä seuraavan kohdan.
* Aseta IRC-siltabotille riittävät oikeudet Matrixissa (PL99 riittää): /op @ircnet:irc.snt.utwente.nl 99
* Aseta Matrix-kanavalle "Change permissions"-oikeus vaatimaan tason 99, jos haluat että silta voi asettaa IRC-puolen opit moderaattoreiksi.
* JOS IRC-kanava on invite only (+i), kutsu IRC-siltabotti sinne: IRCissä /invite SNTMatrixBot

== JSON-pyyntö ==

Tee seuraavanlainen curl-komento (kirjoita vaikka tekstieditorissa ja copypastea terminaaliin):

<pre>
curl --location --request POST 'https://matrix-irc.snt.utwente.nl/ircnet/provision/link' --header 'Content-Type: application/json' --data-binary '{
"remote_room_server": "irc.snt.utwente.nl",
"remote_room_channel": "#esimerkki",
"matrix_room_id": "!paLjOnKirJAimiA:palvelin.fi",
"op_nick": "opin_nick",
"user_id": "@sina:palvelin.org"
}'
</pre>

=== Vahvistus ===

Siltabotti kysyy nyt opin_nick-käyttäjältä IRC:ssä yksityisviestissä:

<SNTMatrixBot> @sina:palvelin.org has requested to bridge 'Kanavan nimi' (https://matrix.to/#/#kanava:palvelin.org) with #esimerkki on this IRC network. Respond with 'yes' or 'y' to allow, or simply ignore this message to disallow. You have 600 seconds from when this message was sent.

Vastaa: yes

Silta on nyt valmis! Jos on ongelmia, kysele IRCNet-sillan kanavalla #ircnet:utwente.io

=== Lopuksi ===

Tässä vaiheessa on varsinkin uudella kanavalla hyvä varmistaa että kanava on salainen +s ja vain opit voivat vaihtaa topicin +t. Lisäksi
kannattaa asettaa reop-lista +R jotta opit eivat katoa IRCin puolella.
Huomaa että Matrix-sillan luomilla IRCNet-käyttäjillä on uniikki pysyvä IPv6-osoite, eli sitä voi käyttää reop-listalla.

Sano IRC-käyttäjänä:

/mode #esimerkki +st +R *!matrixuuser@2001:xxx:yyy:zzz:0:0:0:xxxx +R *!ircuuseri@palvelin.fi

= Kanavan päivitys =

IRC-silta OSAA seurata kanavapäivitystä. Jos päivität kanavan uuteen versioon, silta tunnistaa sen ja käyttäjät tulevat automaattisesti kanavalle. Tämä tosin tapahtuu vasta kun käyttäjä sanoo jotakin tai silta käynnistetään uudelleen.

= Portaalikanavan muuttaminen plumbatuksi =

Tee näin ja tässä järjestyksessä:
* Hanki opit IRC-kanavalla oikealla IRC-käyttäjällä.
* Perusta uusi Matrix-kanava
* Pura silta (katso kohta Sillan purkaminen)
* Siltaa uusi kanava
* Tee tombstone vanhalle kanavalle osoittamaan uuteen

Huom! Jos et pura siltaa ennen plumbausta, silta jää elämään kahdelle kanavalle eikä sitä saa vanhalta omatoimisesti pois. Tämä lienee bugi IRC-sillassa.

= Sillan purkaminen =

Sillan pitäisi purkautua kun viimeinen Matrix-käyttäjä poistuu kanavalta.

Jos haluat purkaa sillan ja säilyttää Matrix-kanavan, tee seuraavasti (Esimerkki IRCNetissä):

* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Selvitä IRC-kanavan nimi IRC-verkossa
* Varmista että sinulla on op-status IRC-kanavalla.
* Avaa viestiyhteys integraatiobotille (IRCNetissä @ircnet:irc.snt.utwente.nl) ja katso sen kotipalvelin (IRCNetissä irc.snt.utwente.nl)
* Anna komento integraatiobotille:
<pre>
!unlink !kanavanIdJossaPaljonKirjaimia:palvelin.fi irc.snt.utwente.nl #kanava
</pre>

= Heisenbridge =

[https://github.com/hifi/heisenbridge Heisenbridge] on vaihtoehtoinen IRC-silta, jota käytetään joko henkilökohtaisena puppet-siltana tai relaybottina.

Heisenbridgejä EI ole julkisesti käytettävissä, se käytännössä pitää asentaa omalle kotipalvelimelle.

== Relaysillan plumbaus ==

* Lisää kyseessä oleva IRC-verkko Heiseniin
* Luo uusi Matrix-kanava tarvittaessa, ei salausta
* Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
* Sano verkon huoneessa: plumb !kanavanIdJossaPaljonKirjaimia:palvelin.fi #kanava

== Portaali-IRC-kanavan muuttaminen Heisenbridgelle ==

IRC-sillan luomaa portaalikanavaa ei voi epäsillata !unlink-komennolla, vaan täytyy tehdä uusi kanava:

* Perusta uusi Matrix-huone, ei salausta
* Siirrä kaikki muut sillat uuteen huoneeseen
* Kutsu vanhan huoneen Matrix-käyttäjät uuteen huoneeseen (ÄLÄ käytä tombstonea!)
* Poista vanhan huoneen aliakset ja lisää ne uuteen huoneeseen
* Poista vanha huone spaceista joissa se on, lisää uusi tilalle
* Merkkaa vanha huone jotenkin vanhaksi. Vaihda huoneen nimi vaikka Vanha: (Huoneen nimi)
* Plumbaa uusi huone Heisenbridgellä (kts ylempi otsikko)

Huomaa että vanhalle kanavalle pääsee liittymään yhä toisen IRC-sillan kautta. Näin liittyvät käyttävät näkyvät irkkaajina Matrixin kautta.

== Helpotusta irkkaajille ==

Heisenbridge on ns. relaybot, eli sillä on yksi yhteys irkkiin ja se välittää usean käyttäjän viestit tämän yhden botin kautta:

<botti> <kayttaja> Morjensta!

IRC-clientteihin saa skriptejä, joilla botin osuus kadotetaan näkyvistä:

* Irssi: https://github.com/zouppen/irssi-detelexify/
* WeeChat: https://github.com/weechat/weechat/wiki/Triggers#relaybot

[[Luokka:Matrix]]

Matrix-Signal

2022-07-28T20:46:53Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja Signalin välillä.

'''HUOM: Signal-sillan kanssa on vielä ratkaisemattomia ongelmia, joten sivun sisältö on vielä tynkä'''

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sinä
siltaan.

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille moderaattorioikeudet
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Sano !signal set-relay
** Botti vastaa: Messages from non-logged-in users in this room will now be bridged through your Signal account.
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa: Invite link not available

'''Koska kutsulinkkiä ei saa, ainut tapa kutsua signal-käyttäjiä kanavilla on kutsua heidän kummituskäyttäjänsä Matrixista'''

Signal-kanavalle ei oletuksena ole kutsulinkkiä vaan se täytyy enabloida asetuksista. Sen tekemiseen on tulossa PR https://github.com/mautrix/signal/pull/268

Päivitellään tätä ohjetta kun homma pelaa..

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi

'''HUOM: Tämä ei liene mahdollista ainakaan botin komennoilla? Onnistuisiko tietokantamuutoksella kuten WhatsApp-sillassa'''

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2022-07-28T20:46:13Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja Signalin välillä.

'''HUOM: Signal-sillan kanssa on vielä ratkaisemattomia ongelmia, joten sivun sisältö on vielä tynkä'''

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sinä
siltaan.

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille moderaattorioikeudet
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Sano !signal set-relay
** Botti vastaa: Messages from non-logged-in users in this room will now be bridged through your Signal account.
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa: Invite link not available

'''Koska kutsulinkkiä ei saa, ei ole tiedossa tapaa kutsua signal-käyttäjiä kanavalle'''

Signal-kanavalle ei oletuksena ole kutsulinkkiä vaan se täytyy enabloida asetuksista. Sen tekemiseen on tulossa PR https://github.com/mautrix/signal/pull/268

Päivitellään tätä ohjetta kun homma pelaa..

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi

'''HUOM: Tämä ei liene mahdollista ainakaan botin komennoilla? Onnistuisiko tietokantamuutoksella kuten WhatsApp-sillassa'''

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2022-07-28T20:33:59Z

Cos: /* Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle */

Tässä kerrotaan, kuinka sillataan kanava [[Matrix]]in ja Signalin välillä.

'''HUOM: Signal-sillan kanssa on vielä ratkaisemattomia ongelmia, joten sivun sisältö on vielä tynkä'''

Tarvitset Signal-sillan jota voit käyttää. Esimerkiksi Kapsi ja Pikaviestin.fi tarjoaa sillan jonka käyttäjätunnus on [https://matrix.to/#/@signalbot:kapsi.fi @signalbot:kapsi.fi]

Signal vaatii myös puhelinnumeron. Jos et halua käyttää henk.koht numeroasi välitysbotin kanssa, sinun täytyy rekisteröidä Signal jollekin muulle numerolle ja kirjautua sinä
siltaan.

== Uuden Signal-kanavan luonti olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi
* Anna siltabotille moderaattorioikeudet
* Sano create
** Botti vastaa: Signal chat created. ID: opg0D/7nOyVpA0w3xyxyxyXYXYMwffKe42fQ=
* Sano !signal set-relay
** Botti vastaa: Messages from non-logged-in users in this room will now be bridged through your Signal account.
* Pyydä kutsulinkki kanavalle: sano !signal invite-link
** Botti vastaa: Invite link not available

'''Koska kutsulinkkiä ei saa, ei ole tiedossa tapaa kutsua signal-käyttäjiä kanavalle'''

== Olemassaolevan Signal-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Kutsu Signal-siltabotti Matrix-kanavalle /invite @signalbot:kapsi.fi

'''HUOM: Tämä ei liene mahdollista ainakaan botin komennoilla? Onnistuisiko tietokantamuutoksella kuten WhatsApp-sillassa'''

= Huoneen päivitys =

Ei ole tiedossa osaako Signal-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix-Signal

2022-07-27T12:28:08Z

Cos: Lisätty tynkäversio

Matrix

2022-07-27T12:01:32Z

Cos: /* Ohjeita */

[[Tiedosto:Riot-dark.png|250px|oikea|thumb|Matrixin Element-asiakasohjelma]]

'''Matrix''' on avoin, hajautettu keskusteluprotokolla, jolla voi toteuttaa esimerkiksi Slackin kaltaisen keskustelu- ja ryhmätyöympäristön. Useimmat Matrix-ohjelmistot sekä asiakas- että palvelinpuolella ovat myös vapaaohjelmia. [[Linux.fi:IRC|Linux.fi:n keskustelukanavalle]] pääset myös Matrixia käyttäen. Matrix-keskusteluun liittyminen edellyttää käyttäjätiliä ''kotipalvelimelta'', joka voi olla käyttäjän itse ylläpitämä tai joltain taholta käyttöön saatu.

Matrixiin on iso määrä erilaisia asiakasohjelmia erilaisiin käyttötarkoituksiin. Referenssitoteutus on nimeltään '''[[Element]]''' ja siitä on versiot selaimille, macOS:lle, Windowsille, Linuxille, Androidille ja iOS:lle. Eri asiakasohjelmia on helppo kokeilla ja lista ohjelmista löytyy [https://matrix.org/clients/ täältä].

== Suomalaisia Matrix-palvelimia ==

Matrixissa voit valita mille palvelimelle teet tunnuksesi, aivan kuten sähköpostiosoitetta hankkiessa.

Voit tehdä tunnuksen kaikille avoimelle matrix.org -palvelimelle osoitteessa https://app.element.io/#/register

Matrix.org on kuitenkin usein valtavan käyttäjämääränsä vuoksi ruuhkainen joten on suositeltavaa tehdä tunnus jollekin muulle palvelimelle, jos vaan mahdollista.

Tässä muutama suomalainen palvelin, joille on mahdollista hankkia tunnus:

* https://www.pikaviestin.fi/ - '''Kaikille suomalaisille avoin palvelin'''. Vaatii suomalaisen sähköposti-osoitteen tai pyynnön sähköpostitse. Tekniset resurssit tarjoaa Kapsi Ry.
* https://www.kapsi.fi/palvelut/matrix.html - Kapsi ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://matrix.hacklab.fi/ - Hacklab.fi ry:n palvelin, vaatii jäsenyyden jossain suomen hacklabissa
* https://element.freemail.fi/ - Braene Oy:n ylläpitämä palvelin. Vaatii käyttäjätunnuksen freemail.fi-sähköpostipalvelussa [https://freemail.fi]

Epävirallinen lista avoimista palvelimista löytyy [https://joinmatrix.org/servers/ täältä].

Jos ehdit jo tehdä tunnuksen matrix.org:iin, voit [https://ems.element.io/tools/matrix-migration tällä työkalulla] siirtää tietosi uudelle palvelimelle.

Oman Matrix-kotipalvelimen ylläpitäminen on myös kohtuullisen helppoa ja vertautuu muiden palvelinten pyörittämiseen.

== Suomenkielisiä Matrix-huoneita ==

Matrixissa space tarkoittaa joukkoa huoneita. Niiden avulla voidaan ryhmitellä huoneita esimerkiksi aihepiireittäin ja helpottaa kanavien löytämistä.

Lista tunnetuista avoimet suomenkielisistä huoneista on kerätty [https://matrix.to/#/!WDaMZSVinTZRLOTajM:hacklab.fi?via=hacklab.fi&via=matrix.org&via=kapsi.fi Matrix Suomi] -spaceen.

Huoneisiin pääset helposti kun liityt kyseiseen spaceen jolloin näet listan kanavista.

Voit liittyä spaceen klikkaamalla ylläolevaa linkkiä tai kirjoittamalla '''/join #matrix-suomi:kapsi.fi'''. Jos tiedät huoneen joka puuttuu, pyydä ylläpitäjiä
lisäämään se [https://matrix.to/#/#matrix.fi:matrix.org Matrix.fi-huoneessa]. Kyseisessä huoneessa saat myös vertaistukea Matrixin käyttöön.

Jos tiedät IRC-kanavan jolle haluat liittyä, liity huoneeseen '''#_ircnet_#kanava:irc.snt.utwente.nl''' (IRCNet) tai '''#kanava:libera.chat'''
(libera.chat). Lista kaikista sillatuista verkoista löytyy [https://matrix-org.github.io/matrix-appservice-irc/latest/bridged_networks.html täältä].

Suuri osa suomenkielisistä Matrix-huoneista on sillattu vastaavalle IRC-kanavalle.

== Muun kielisiä vapaaohjelma-aiheisia huoneita ==

* #fosdem:fosdem.org - [[FOSDEM]]-konferenssin pääasiallinen keskusteluhuone
* #revision:hacklab.fi - [https://revision-party.net/ Revision-demopartyt]

== Ohjeita ==

* [[Matrix-IRC|Matrix-IRC-siltaus]]
* [[Matrix-Telegram|Matrix-Telegram-siltaus]]
* [[Matrix-Discord|Matrix-Discord-siltaus]]
* [[Matrix-Signal|Matrix-Signal-siltaus]]

== Katso myös ==

* [https://matrix.org Matrixin verkkosivut ]
* [https://app.element.io/ Elementin, web-pohjaisen Matrix-asiakasohjelman, kirjautumissivu]
* [https://odysee.com/@Luke:7/matrix-vs.-xmpp-which-is-better-for:9 Luke Smithin video Matrix- sekä XMPP-protokollien heikkouksista ja vahvuuksista]
* [https://www.youtube.com/watch?v=v5Y8zCwIxjI Noordstar Legacyn video Matrixin olemuksesta selitettynä säilykepurkeilla ja narulla]

[[Luokka:Pikaviestimet]]
[[Luokka:Verkko]]
[[Luokka:Matrix]]

Matrix-Discord

2022-07-01T07:06:40Z

Cos: Ohje huonepäivityksen tekoon

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Vaihtoehtoinen silta: mx-puppet-discord =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Sillan asennus ja konfigurointi ==

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Ennen kanavien siltausta täytyy sillata kilta.

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

== Huoneen päivitys ==

Tämä Discord-silta EI osaa ainakaan toistaisemsi seurata huonepäivityksiä (room upgrade). Jos päivität huoneen, tee seuraavasti:

* Botin komentohuoneessa epäsiltaa k.o huone: unbridge 3 87xxxxxxxxx91
* Päivitä huone (ei haittaa jos se on jo päivitetty)
* Kutsu siltabotti uuteen huoneeseen
* Siltaa uudestaan, huoneessa: !discord bridge 3 87xxxxxxxxx91

Numero 3 on esimerkissä puppet id ja 87xxxxxxxxx91 kanavan id discordista.

== Yleisiä ongelmia ==

=== Discordin puolelle viestit tulevat "laatikoissa" ===

* Varmista että Discord-admin antoi botin vaatimat oikeudet
* Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
* Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.

[[Luokka:Matrix]]

Matrix-IRC

2022-04-11T10:34:40Z

Cos: /* Valmistelu */

Matrix-IRC

2022-04-11T07:29:51Z

Cos: /* Valmistelu */ PL99 riittää

Matrix-Discord

2022-03-16T19:56:56Z

Cos: /* Vaihtoehtoinen silta: mx-puppet-discord */ Lisätty yleisiä ongelmia

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Vaihtoehtoinen silta: mx-puppet-discord =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Sillan asennus ja konfigurointi ==

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Ennen kanavien siltausta täytyy sillata kilta.

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

== Yleisiä ongelmia ==

=== Discordin puolelle viestit tulevat "laatikoissa" ===

* Varmista että Discord-admin antoi botin vaatimat oikeudet
* Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
* Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.

[[Luokka:Matrix]]

Matrix

2021-12-26T13:52:03Z

Cos: /* Suomalaisia Matrix-palvelimia */ Siirretty pikaviestin.fi listan kärkeen ja lihavoitu.

Matrix

2021-11-19T22:56:30Z

Cos: Parempi serverilista

Matrix

2021-10-22T08:29:08Z

Cos: /* Suomalaisia Matrix-palvelimia */ Parempi palvelinlista

Matrix-Telegram

2021-10-03T16:57:07Z

Cos: /* Olemassaolevan Telegram-kanavan siltaus olemassaolevalle Matrix-kanavalle */ Tarkennettu kanavan ID:n selvitysohjetta

Tässä kerrotaan kuinka sillataan [[Matrix|Matrix-kanava]] uuteen tai olemassaolevaan Telegram-kanavaan.

Huomaa, että Telegram-siltoja on useita ja voit ajaa sellaista myös omalla palvelimella. Jos et tiedä mitä siltainstanssia käyttäisit, voit
käyttää [https://t2bot.io/ t2bot.io]-palvelun tarjoamaa julkista siltaa.

== Tarvittavat tiedot ==

* Telegram-botin mxid: Esim @telegram:t2bot.io
* Telegram-botin Telegram-tunnus (jos siltaat olemassaolevaa tg-kanavaa): esim @matrix_t2bot

Telegram-botti ei tarvitse ylimääräisiä oikeuksia Matrixin puolella.

== Uuden Telegram-kanavan luonti olemassaolevalle Matrix-kanavalle ==

Huom: t2bot.io:n sillan asetusten vuoksi tämä ei onnistu. Käytä jotain muuta
siltaa tai tee kanava oikealla Telegram-tunnuksella ensin ja siltaa se.

* Kutsu Telegram-siltabotti Matrix-kanavalle /invite @telegrambot:palvelin.fi
* Sano !tg ping-bot

Botti vastaa:

"Telegram message relay bot is active: sillanbridgebot (ID 514401234)

To use the bot, simply invite it to a portal room."

* Kutsu tuo mainittu käyttäjä Matrix-kanavalle
* Sano !tg create

Botti vastaa: Telegram chat created. ID: 13220123123

Valmis! Voit katsoa Telegram-kutsulinkin komennolla !tg invite-link

== Olemassaolevan Telegram-kanavan siltaus olemassaolevalle Matrix-kanavalle ==

* Kutsu Telegram-siltabotti Matrix-kanavalle /invite @telegram:t2bot.io
* Kutsu Telegramin puolella siltabotti Telegram-kanavalle

=== Selvitä kanavan ID telegramissa ===

* Sano Telegramissa /id - botti vastaa numerolla
* Jos olet jo tg-kanavalla henkilökohtaisen sillan kautta, käytä Matrixissa komentoa !tg id

=== Siltaus ===

* Sano Matrixissa !tg bridge --usebot <numero>

Botti kysyy vahvistuksen ja tämän jälkeen nostaa sillan pystyyn.

= Huoneen päivitys =

Telegram-silta osaa seurata huonepäivityksiä (room upgrade).

[[Luokka:Matrix]]

Matrix

2021-09-22T11:41:43Z

Cos: /* Suomenkielisiä Matrix-huoneita */ Päivitetty sillattujen verkkojen lista

Matrix

2021-09-22T11:35:15Z

Cos: /* Suomenkielisiä Matrix-huoneita */ Vaihdetty freenode liberaksi.

Matrix-IRC

2021-09-08T10:19:54Z

Cos: Ohje portaalin muuttamisen plumbatuksi

Matrix

2021-08-30T20:16:52Z

Cos: /* Suomenkielisiä Matrix-huoneita */

Matrix

2021-08-30T20:14:39Z

Cos: Koko sivua siivottu ja järjestelty. Lisätty Noordstar Legacyn video.

Matrix

2021-08-30T20:06:50Z

Cos: /* Suomenkielisiä Matrix-huoneita */ Korvattu lista ohjeella spaceen liittymisestä.

Matrix-Discord

2021-08-23T14:40:42Z

Cos: /* Kanavien siltaus */

Matrix-IRC

2021-08-10T18:54:27Z

Cos: /* Valmistelu */

Matrix-Discord

2021-08-10T09:30:31Z

Cos: /* Vaihtoehtoinen silta: mx-puppet-discord */

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Vaihtoehtoinen silta: mx-puppet-discord =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Sillan asennus ja konfigurointi ==

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

[[Luokka:Matrix]]

Matrix-Discord

2021-08-09T21:09:16Z

Cos: Lisätty ohje mx-puppet-discordin käyttöön

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

== Tarvittavat tiedot ==

* Discord-kanavan serverid- ja channelid-numerot. Nämä pitäisi näkyä webbidiscordin URLeissa muodossa https://discordapp.com/channels/ServerID/ChannelID
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.

== Discord-puoli ==

* Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

== Matrix-puoli ==

* Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
* Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

= Kanavan päivitys =

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

= Vaihtoehtoinen silta: mx-puppet-discord =

[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.

== Botin teko discordiin ==

Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

== Sillan yhdistäminen bottiin ==

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

== Botin säätö ==

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

== Kanavien siltaus ==

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

[[Luokka:Matrix]]

Matrix-IRC

2021-08-08T19:12:24Z

Cos: /* Valmistelu */

Matrix-IRC

2021-05-24T14:15:57Z

Cos: /* Sillan purkaminen */ Tarkennettu ohjeita

Matrix-IRC

2021-05-24T14:01:50Z

Cos: Lisätty ohje sillan purkamiseksi

Matrix

2021-05-19T08:21:23Z

Cos: /* Suomenkielisiä Matrix-huoneita */ Lisätty suomi-space varotuksineen

[[Tiedosto:Riot-dark.png|250px|oikea|thumb|Matrixin Element-asiakasohjelma]]
{{vaihtoehdot|keskusteluprotokollaa|Komennosta|cmatrix}}

'''Matrix''' on avoin, hajautettu keskusteluprotokolla, jolla voi toteuttaa esimerkiksi Slackin kaltaisen keskustelu- ja ryhmätyöympäristön. Useimmat Matrix-ohjelmistot sekä asiakas- että palvelinpuolella ovat myös vapaaohjelmia. [[Linux.fi:IRC|Linux.fi:n keskustelukanavalle]] pääset myös Matrixia käyttäen. Matrix-keskusteluun liittyminen edellyttää käyttäjätiliä ''kotipalvelimelta'', joka voi olla käyttäjän itse ylläpitämä tai joltain taholta käyttöön saatu.

Matrixiin on iso määrä erilaisia asiakasohjelmia erilaisiin käyttötarkoituksiin. Referenssitoteutus on nimeltään '''[[Element]]''' ja siitä on versiot selaimille, macOS:lle, Windowsille, Linuxille, Androidille ja iOS:lle. Eri asiakasohjelmia on helppo kokeilla ja lista ohjelmista löytyy sivulta https://matrix.org/clients/

== Suomalaisia Matrix-palvelimia ==

Matrixissa voit valita mille palvelimelle teet tunnuksesi, aivan kuten sähköpostiosoitetta hankkiessa.

Voit tehdä tunnuksen kaikille avoimelle matrix.org -palvelimelle osoitteessa https://app.element.io/#/register

Matrix.org on kuitenkin usein valtavan käyttäjämääränsä vuoksi ruuhkainen joten on suositeltavaa tehdä tunnus jollekin muulle palvelimelle, jos vaan mahdollista.

Epävirallinen lista avoimista palvelimista löytyy [https://www.anchel.nl/matrix-publiclist/ täältä].

Tässä muutama suomalainen palvelin, joille on mahdollista hankkia tunnus:

* https://chat.feneas.org/ - FENEAS ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://www.kapsi.fi/palvelut/matrix.html - Kapsi ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://matrix.hacklab.fi/ - Hacklab.fi ry:n palvelin, vaatii jäsenyyden jossain suomen hacklabissa
* https://element.freemail.fi/ - Braene Oy:n ylläpitämä palvelin. Vaatii käyttäjätunnuksen freemail.fi-sähköpostipalvelussa [https://freemail.fi]

Jos ehdit jo tehdä tunnuksen matrix.org:iin, voit [https://ems.element.io/tools/matrix-migration tällä työkalulla] siirtää tietosi uudelle palvelimelle.

Oman Matrix-kotipalvelimen ylläpitäminen on myös kohtuullisen helppoa ja vertautuu muiden palvelinten pyörittämiseen.

== Suomenkielisiä Matrix-huoneita ==

Liity esim kirjoittamalla '''/join #kanava:palvelin'''

Jos tiedät IRC-kanavan jolle haluat liittyä, liity kanavalle '''#_ircnet_#kanava:irc.snt.utwente.nl''' (IRCNet)
tai '''#freenode_#kanava:matrix.org''' (freenode). Muut verkot löytyy [https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks täältä].

Valtaosa suomenkielisistä Matrix-kanavista on sillattu vastaavalle IRC-kanavalle.

=== Tekniikka ja tiede ===

* #matrix.fi:matrix.org - Suomalaiset Matrix-käyttäjät, apua ja vertaistukea Matrixin käyttöön
* #linux.fi:linux.fi - Linux.fi
* #lennokit:matrix.org - Lennokki- ja kopteriharrastajat
* #tietokonelaitteistot:matrix.org - Tietokonelaitteisiin liittyvä keskustelu
* #amigafin:hacklab.fi - Amigaharrastajat
* #rintamamiestalo:hacklab.fi - Rintamamiestalojen omistajien tukiryhmä
* #fediversumi:kapsi.fi - Keskustelua federoiduista verkkopalveluista
* #vr-harrastajat:hacklab.fi - Keskustelua virtuaalitodellisuuslaittista ja softista
* #sysadm.fi:hacklab.fi - Palvelinten ylläpitäjät
* #ohjelmointi:hacklab.fi - Keskustelua ohjelmoinnista eri kielillä
* #avoindata:hacklab.fi - Keskustelua avoimesta datasta
* #elektroniikka:hacklab.fi - Elektroniikka
* #hamit:hacklab.fi - Radioamatöörit
* #Teollinen_IoT:hacklab.fi - Keskustelua teollisesta internet of thingsistä

=== Taide ja kulttuuri ===

* #turunsyntetisaattoriseura:matrix.org - Turun syntetisaattoriseura (oikeasti globaali ja kaikille avoin)
* #skrolli:hacklab.fi - Skrolli -lehti (tietokonekulttuurin erikoislehti) [https://skrolli.fi/ WWW-sivut]
* #suomiscene:hacklab.fi - Demoscene -harrastajat
* #wappuradio:hacklab.fi - Rakkauden Wappuradio (Tamperelainen opiskelijaradio, IRCNetin ison kanava joka ei liity waretukseen) [https://wappuradio.fi/ Radion WWW-sivut]
* #kirjasuositukset:kapsi.fi - Keskustelua kirjoista
* #hakkeriradio:hacklab.fi - Hakkeriradio - erikoistunut elektroniseen musiikkiin ja digitaalisen maailman ilmiöihin. [https://hakkeriradio.fi/ Radion WWW-sivut]
* #kovaydin:hacklab.fi - Kovaydin.NET on nettiyhteisö, bilejärjestö, nettilafka ja elektronisen underground *core-musiikin sanansaattaja Suomessa [https://kovaydin.net/ WWW-sivut]
* #sslnr:hacklab.fi - Suomalaiset spiikatut livenettiradiot. Täällä voi mainostaa ja linkata suomeksi puhuttuja, livenä tulevia nettiradioita ja videostriimejä
* #rattoradio:hacklab.fi - Oululainen opiskelijoiden wappuradio
* #scenelounge:hacklab.fi - Assembly -demopartyjen Demoscenenurkkaus

=== Yhteisöt ===

* #general:hacklab.fi - Suomen hacklabien yhteiskanava (yksittäisillä labeilla on omansa)
* #kuppilatiima:hacklab.fi - Ilmailu, eri lajit, harrastajia ja ammattilaisia
* #sirius:hacklab.fi - Tähtitiede ja avaruus
* #taivaanvahti:hacklab.fi - Taivaanvahti -palvelun havaintoraportit
* #pyoraily:hacklab.fi - Polkupyöräily sähköllä tai ilman
* #yksivaihde:hacklab.fi - Fiksipyöräily

=== Pelit ===

* #warbirds:hacklab.fi - Virtuaalilentäjät (virtuaali-ilmailua, ilmailu & sotahistoriaa - IL2-sarja, DCS, X-Plane, jne)
* #condorsuomi:matrix.org - Condor-purjelentosimulaattori
* #freeciv.fi:ellipsis.fi - [http://freeciv.org Freeciv], vapaa Civilization-klooni

=== Paikalliset ===

==== Tampere ====
* #tampere:matrix.org - Tampereen yleiskanava
* #lautapelit_tre:matrix.org - Lautapeliseuraa

== Suomenkieliset Matrix-spacet ==

Matrixissa space tarkoittaa joukkoa kanavia. Niiden avulla voidaan ryhmitellä kanavia esimerkiksi aihepiireittäin ja helpottaa kanavien löytämistä.

Spacet ovat vielä beta-vaiheessa joten niiden kanssa voi olla ongelmia. Erityisesti tällä hetkellä sillatut IRC-kanavat, joilla et ole eivät näy spaceissa. Tähän on tekeillään korjaus.

Matrix Suomi-spaceen jossa on tunnetut julkiset spacet listattuna voit liittyä [https://matrix.to/#/!WDaMZSVinTZRLOTajM:hacklab.fi?via=hacklab.fi&via=kapsi.fi&via=matrix.org tästä].

== Muun kielisiä vapaaohjelma-aiheisia huoneita ==

* #fosdem:fosdem.org - [[FOSDEM]]-konferenssin pääasiallinen keskusteluhuone
* #revision:hacklab.fi - [https://revision-party.net/ Revision-demopartyt]

== Ohjeita ==

* [[Matrix-IRC|Matrix-IRC-siltaus]]
* [[Matrix-Telegram|Matrix-Telegram-siltaus]]
* [[Matrix-Discord|Matrix-Discord-siltaus]]

==Katso myös==

* [https://matrix.org Matrixin verkkosivut ]
* [https://app.element.io/ Elementin, web-pohjaisen Matrix-asiakasohjelman, kirjautumissivu]

[[Luokka:Pikaviestimet]]
[[Luokka:Verkko]]

Matrix

2021-05-07T13:48:03Z

Cos: /* Paikalliset */ Tre lautapelit ja vähän muotoilua

[[Tiedosto:Riot-dark.png|250px|oikea|thumb|Matrixin Element-asiakasohjelma]]
{{vaihtoehdot|keskusteluprotokollaa|Komennosta|cmatrix}}

'''Matrix''' on avoin, hajautettu keskusteluprotokolla, jolla voi toteuttaa esimerkiksi Slackin kaltaisen keskustelu- ja ryhmätyöympäristön. Useimmat Matrix-ohjelmistot sekä asiakas- että palvelinpuolella ovat myös vapaaohjelmia. [[Linux.fi:IRC|Linux.fi:n keskustelukanavalle]] pääset myös Matrixia käyttäen. Matrix-keskusteluun liittyminen edellyttää käyttäjätiliä ''kotipalvelimelta'', joka voi olla käyttäjän itse ylläpitämä tai joltain taholta käyttöön saatu.

Matrixiin on iso määrä erilaisia asiakasohjelmia erilaisiin käyttötarkoituksiin. Referenssitoteutus on nimeltään '''[[Element]]''' ja siitä on versiot selaimille, macOS:lle, Windowsille, Linuxille, Androidille ja iOS:lle. Eri asiakasohjelmia on helppo kokeilla ja lista ohjelmista löytyy sivulta https://matrix.org/clients/

== Suomalaisia Matrix-palvelimia ==

Matrixissa voit valita mille palvelimelle teet tunnuksesi, aivan kuten sähköpostiosoitetta hankkiessa.

Voit tehdä tunnuksen kaikille avoimelle matrix.org -palvelimelle osoitteessa https://app.element.io/#/register

Matrix.org on kuitenkin usein valtavan käyttäjämääränsä vuoksi ruuhkainen joten on suositeltavaa tehdä tunnus jollekin muulle palvelimelle, jos vaan mahdollista.

Epävirallinen lista avoimista palvelimista löytyy [https://www.anchel.nl/matrix-publiclist/ täältä].

Tässä muutama suomalainen palvelin, joille on mahdollista hankkia tunnus:

* https://chat.feneas.org/ - FENEAS ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://www.kapsi.fi/palvelut/matrix.html - Kapsi ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://matrix.hacklab.fi/ - Hacklab.fi ry:n palvelin, vaatii jäsenyyden jossain suomen hacklabissa
* https://element.freemail.fi/ - Braene Oy:n ylläpitämä palvelin. Vaatii käyttäjätunnuksen freemail.fi-sähköpostipalvelussa [https://freemail.fi]

Jos ehdit jo tehdä tunnuksen matrix.org:iin, voit [https://ems.element.io/tools/matrix-migration tällä työkalulla] siirtää tietosi uudelle palvelimelle.

Oman Matrix-kotipalvelimen ylläpitäminen on myös kohtuullisen helppoa ja vertautuu muiden palvelinten pyörittämiseen.

== Suomenkielisiä Matrix-huoneita ==

Liity esim kirjoittamalla '''/join #kanava:palvelin'''

Jos tiedät IRC-kanavan jolle haluat liittyä, liity kanavalle '''#_ircnet_#kanava:irc.snt.utwente.nl''' (IRCNet)
tai '''#freenode_#kanava:matrix.org''' (freenode). Muut verkot löytyy [https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks täältä].

Valtaosa suomenkielisistä Matrix-kanavista on sillattu vastaavalle IRC-kanavalle.

=== Tekniikka ja tiede ===

* #matrix.fi:matrix.org - Suomalaiset Matrix-käyttäjät, apua ja vertaistukea Matrixin käyttöön
* #linux.fi:linux.fi - Linux.fi
* #lennokit:matrix.org - Lennokki- ja kopteriharrastajat
* #tietokonelaitteistot:matrix.org - Tietokonelaitteisiin liittyvä keskustelu
* #amigafin:hacklab.fi - Amigaharrastajat
* #rintamamiestalo:hacklab.fi - Rintamamiestalojen omistajien tukiryhmä
* #fediversumi:kapsi.fi - Keskustelua federoiduista verkkopalveluista
* #vr-harrastajat:hacklab.fi - Keskustelua virtuaalitodellisuuslaittista ja softista
* #sysadm.fi:hacklab.fi - Palvelinten ylläpitäjät
* #ohjelmointi:hacklab.fi - Keskustelua ohjelmoinnista eri kielillä
* #avoindata:hacklab.fi - Keskustelua avoimesta datasta
* #elektroniikka:hacklab.fi - Elektroniikka
* #hamit:hacklab.fi - Radioamatöörit
* #Teollinen_IoT:hacklab.fi - Keskustelua teollisesta internet of thingsistä

=== Taide ja kulttuuri ===

* #turunsyntetisaattoriseura:matrix.org - Turun syntetisaattoriseura (oikeasti globaali ja kaikille avoin)
* #skrolli:hacklab.fi - Skrolli -lehti (tietokonekulttuurin erikoislehti) [https://skrolli.fi/ WWW-sivut]
* #suomiscene:hacklab.fi - Demoscene -harrastajat
* #wappuradio:hacklab.fi - Rakkauden Wappuradio (Tamperelainen opiskelijaradio, IRCNetin ison kanava joka ei liity waretukseen) [https://wappuradio.fi/ Radion WWW-sivut]
* #kirjasuositukset:kapsi.fi - Keskustelua kirjoista
* #hakkeriradio:hacklab.fi - Hakkeriradio - erikoistunut elektroniseen musiikkiin ja digitaalisen maailman ilmiöihin. [https://hakkeriradio.fi/ Radion WWW-sivut]
* #kovaydin:hacklab.fi - Kovaydin.NET on nettiyhteisö, bilejärjestö, nettilafka ja elektronisen underground *core-musiikin sanansaattaja Suomessa [https://kovaydin.net/ WWW-sivut]
* #sslnr:hacklab.fi - Suomalaiset spiikatut livenettiradiot. Täällä voi mainostaa ja linkata suomeksi puhuttuja, livenä tulevia nettiradioita ja videostriimejä
* #rattoradio:hacklab.fi - Oululainen opiskelijoiden wappuradio
* #scenelounge:hacklab.fi - Assembly -demopartyjen Demoscenenurkkaus

=== Yhteisöt ===

* #general:hacklab.fi - Suomen hacklabien yhteiskanava (yksittäisillä labeilla on omansa)
* #kuppilatiima:hacklab.fi - Ilmailu, eri lajit, harrastajia ja ammattilaisia
* #sirius:hacklab.fi - Tähtitiede ja avaruus
* #taivaanvahti:hacklab.fi - Taivaanvahti -palvelun havaintoraportit
* #pyoraily:hacklab.fi - Polkupyöräily sähköllä tai ilman
* #yksivaihde:hacklab.fi - Fiksipyöräily

=== Pelit ===

* #warbirds:hacklab.fi - Virtuaalilentäjät (virtuaali-ilmailua, ilmailu & sotahistoriaa - IL2-sarja, DCS, X-Plane, jne)
* #condorsuomi:matrix.org - Condor-purjelentosimulaattori
* #freeciv.fi:ellipsis.fi - [http://freeciv.org Freeciv], vapaa Civilization-klooni

=== Paikalliset ===

==== Tampere ====
* #tampere:matrix.org - Tampereen yleiskanava
* #lautapelit_tre:matrix.org - Lautapeliseuraa

== Muun kielisiä vapaaohjelma-aiheisia huoneita ==

* #fosdem:fosdem.org - [[FOSDEM]]-konferenssin pääasiallinen keskusteluhuone
* #revision:hacklab.fi - [https://revision-party.net/ Revision-demopartyt]

== Ohjeita ==

* [[Matrix-IRC|Matrix-IRC-siltaus]]
* [[Matrix-Telegram|Matrix-Telegram-siltaus]]
* [[Matrix-Discord|Matrix-Discord-siltaus]]

==Katso myös==

* [https://matrix.org Matrixin verkkosivut ]
* [https://app.element.io/ Elementin, web-pohjaisen Matrix-asiakasohjelman, kirjautumissivu]

[[Luokka:Pikaviestimet]]
[[Luokka:Verkko]]

Matrix

2021-05-07T11:16:43Z

Cos: /* Taide ja kulttuuri */ Lisätty scenelounge

[[Tiedosto:Riot-dark.png|250px|oikea|thumb|Matrixin Element-asiakasohjelma]]
{{vaihtoehdot|keskusteluprotokollaa|Komennosta|cmatrix}}

'''Matrix''' on avoin, hajautettu keskusteluprotokolla, jolla voi toteuttaa esimerkiksi Slackin kaltaisen keskustelu- ja ryhmätyöympäristön. Useimmat Matrix-ohjelmistot sekä asiakas- että palvelinpuolella ovat myös vapaaohjelmia. [[Linux.fi:IRC|Linux.fi:n keskustelukanavalle]] pääset myös Matrixia käyttäen. Matrix-keskusteluun liittyminen edellyttää käyttäjätiliä ''kotipalvelimelta'', joka voi olla käyttäjän itse ylläpitämä tai joltain taholta käyttöön saatu.

Matrixiin on iso määrä erilaisia asiakasohjelmia erilaisiin käyttötarkoituksiin. Referenssitoteutus on nimeltään '''[[Element]]''' ja siitä on versiot selaimille, macOS:lle, Windowsille, Linuxille, Androidille ja iOS:lle. Eri asiakasohjelmia on helppo kokeilla ja lista ohjelmista löytyy sivulta https://matrix.org/clients/

== Suomalaisia Matrix-palvelimia ==

Matrixissa voit valita mille palvelimelle teet tunnuksesi, aivan kuten sähköpostiosoitetta hankkiessa.

Voit tehdä tunnuksen kaikille avoimelle matrix.org -palvelimelle osoitteessa https://app.element.io/#/register

Matrix.org on kuitenkin usein valtavan käyttäjämääränsä vuoksi ruuhkainen joten on suositeltavaa tehdä tunnus jollekin muulle palvelimelle, jos vaan mahdollista.

Epävirallinen lista avoimista palvelimista löytyy [https://www.anchel.nl/matrix-publiclist/ täältä].

Tässä muutama suomalainen palvelin, joille on mahdollista hankkia tunnus:

* https://chat.feneas.org/ - FENEAS ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://www.kapsi.fi/palvelut/matrix.html - Kapsi ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://matrix.hacklab.fi/ - Hacklab.fi ry:n palvelin, vaatii jäsenyyden jossain suomen hacklabissa
* https://element.freemail.fi/ - Braene Oy:n ylläpitämä palvelin. Vaatii käyttäjätunnuksen freemail.fi-sähköpostipalvelussa [https://freemail.fi]

Jos ehdit jo tehdä tunnuksen matrix.org:iin, voit [https://ems.element.io/tools/matrix-migration tällä työkalulla] siirtää tietosi uudelle palvelimelle.

Oman Matrix-kotipalvelimen ylläpitäminen on myös kohtuullisen helppoa ja vertautuu muiden palvelinten pyörittämiseen.

== Suomenkielisiä Matrix-huoneita ==

Liity esim kirjoittamalla '''/join #kanava:palvelin'''

Jos tiedät IRC-kanavan jolle haluat liittyä, liity kanavalle '''#_ircnet_#kanava:irc.snt.utwente.nl''' (IRCNet)
tai '''#freenode_#kanava:matrix.org''' (freenode). Muut verkot löytyy [https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks täältä].

Valtaosa suomenkielisistä Matrix-kanavista on sillattu vastaavalle IRC-kanavalle.

=== Tekniikka ja tiede ===

* #matrix.fi:matrix.org - Suomalaiset Matrix-käyttäjät, apua ja vertaistukea Matrixin käyttöön
* #linux.fi:linux.fi - Linux.fi
* #lennokit:matrix.org - Lennokki- ja kopteriharrastajat
* #tietokonelaitteistot:matrix.org - Tietokonelaitteisiin liittyvä keskustelu
* #amigafin:hacklab.fi - Amigaharrastajat
* #rintamamiestalo:hacklab.fi - Rintamamiestalojen omistajien tukiryhmä
* #fediversumi:kapsi.fi - Keskustelua federoiduista verkkopalveluista
* #vr-harrastajat:hacklab.fi - Keskustelua virtuaalitodellisuuslaittista ja softista
* #sysadm.fi:hacklab.fi - Palvelinten ylläpitäjät
* #ohjelmointi:hacklab.fi - Keskustelua ohjelmoinnista eri kielillä
* #avoindata:hacklab.fi - Keskustelua avoimesta datasta
* #elektroniikka:hacklab.fi - Elektroniikka
* #hamit:hacklab.fi - Radioamatöörit
* #Teollinen_IoT:hacklab.fi - Keskustelua teollisesta internet of thingsistä

=== Taide ja kulttuuri ===

* #turunsyntetisaattoriseura:matrix.org - Turun syntetisaattoriseura (oikeasti globaali ja kaikille avoin)
* #skrolli:hacklab.fi - Skrolli -lehti (tietokonekulttuurin erikoislehti) [https://skrolli.fi/ WWW-sivut]
* #suomiscene:hacklab.fi - Demoscene -harrastajat
* #wappuradio:hacklab.fi - Rakkauden Wappuradio (Tamperelainen opiskelijaradio, IRCNetin ison kanava joka ei liity waretukseen) [https://wappuradio.fi/ Radion WWW-sivut]
* #kirjasuositukset:kapsi.fi - Keskustelua kirjoista
* #hakkeriradio:hacklab.fi - Hakkeriradio - erikoistunut elektroniseen musiikkiin ja digitaalisen maailman ilmiöihin. [https://hakkeriradio.fi/ Radion WWW-sivut]
* #kovaydin:hacklab.fi - Kovaydin.NET on nettiyhteisö, bilejärjestö, nettilafka ja elektronisen underground *core-musiikin sanansaattaja Suomessa [https://kovaydin.net/ WWW-sivut]
* #sslnr:hacklab.fi - Suomalaiset spiikatut livenettiradiot. Täällä voi mainostaa ja linkata suomeksi puhuttuja, livenä tulevia nettiradioita ja videostriimejä
* #rattoradio:hacklab.fi - Oululainen opiskelijoiden wappuradio
* #scenelounge:hacklab.fi - Assembly -demopartyjen Demoscenenurkkaus

=== Yhteisöt ===

* #general:hacklab.fi - Suomen hacklabien yhteiskanava (yksittäisillä labeilla on omansa)
* #kuppilatiima:hacklab.fi - Ilmailu, eri lajit, harrastajia ja ammattilaisia
* #sirius:hacklab.fi - Tähtitiede ja avaruus
* #taivaanvahti:hacklab.fi - Taivaanvahti -palvelun havaintoraportit
* #pyoraily:hacklab.fi - Polkupyöräily sähköllä tai ilman
* #yksivaihde:hacklab.fi - Fiksipyöräily

=== Pelit ===

* #warbirds:hacklab.fi - Virtuaalilentäjät (virtuaali-ilmailua, ilmailu & sotahistoriaa - IL2-sarja, DCS, X-Plane, jne)
* #condorsuomi:matrix.org - Condor-purjelentosimulaattori
* #freeciv.fi:ellipsis.fi - [http://freeciv.org Freeciv], vapaa Civilization-klooni

=== Paikalliset ===

* #tampere:matrix.org - Tampere

== Muun kielisiä vapaaohjelma-aiheisia huoneita ==

* #fosdem:fosdem.org - [[FOSDEM]]-konferenssin pääasiallinen keskusteluhuone
* #revision:hacklab.fi - [https://revision-party.net/ Revision-demopartyt]

== Ohjeita ==

* [[Matrix-IRC|Matrix-IRC-siltaus]]
* [[Matrix-Telegram|Matrix-Telegram-siltaus]]
* [[Matrix-Discord|Matrix-Discord-siltaus]]

==Katso myös==

* [https://matrix.org Matrixin verkkosivut ]
* [https://app.element.io/ Elementin, web-pohjaisen Matrix-asiakasohjelman, kirjautumissivu]

[[Luokka:Pikaviestimet]]
[[Luokka:Verkko]]

Matrix

2021-05-07T10:54:14Z

Cos: /* Suomenkielisiä Matrix-huoneita */

[[Tiedosto:Riot-dark.png|250px|oikea|thumb|Matrixin Element-asiakasohjelma]]
{{vaihtoehdot|keskusteluprotokollaa|Komennosta|cmatrix}}

'''Matrix''' on avoin, hajautettu keskusteluprotokolla, jolla voi toteuttaa esimerkiksi Slackin kaltaisen keskustelu- ja ryhmätyöympäristön. Useimmat Matrix-ohjelmistot sekä asiakas- että palvelinpuolella ovat myös vapaaohjelmia. [[Linux.fi:IRC|Linux.fi:n keskustelukanavalle]] pääset myös Matrixia käyttäen. Matrix-keskusteluun liittyminen edellyttää käyttäjätiliä ''kotipalvelimelta'', joka voi olla käyttäjän itse ylläpitämä tai joltain taholta käyttöön saatu.

Matrixiin on iso määrä erilaisia asiakasohjelmia erilaisiin käyttötarkoituksiin. Referenssitoteutus on nimeltään '''[[Element]]''' ja siitä on versiot selaimille, macOS:lle, Windowsille, Linuxille, Androidille ja iOS:lle. Eri asiakasohjelmia on helppo kokeilla ja lista ohjelmista löytyy sivulta https://matrix.org/clients/

== Suomalaisia Matrix-palvelimia ==

Matrixissa voit valita mille palvelimelle teet tunnuksesi, aivan kuten sähköpostiosoitetta hankkiessa.

Voit tehdä tunnuksen kaikille avoimelle matrix.org -palvelimelle osoitteessa https://app.element.io/#/register

Matrix.org on kuitenkin usein valtavan käyttäjämääränsä vuoksi ruuhkainen joten on suositeltavaa tehdä tunnus jollekin muulle palvelimelle, jos vaan mahdollista.

Epävirallinen lista avoimista palvelimista löytyy [https://www.anchel.nl/matrix-publiclist/ täältä].

Tässä muutama suomalainen palvelin, joille on mahdollista hankkia tunnus:

* https://chat.feneas.org/ - FENEAS ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://www.kapsi.fi/palvelut/matrix.html - Kapsi ry:n palvelin, vaatii yhdistyksen jäsenyyden
* https://matrix.hacklab.fi/ - Hacklab.fi ry:n palvelin, vaatii jäsenyyden jossain suomen hacklabissa
* https://element.freemail.fi/ - Braene Oy:n ylläpitämä palvelin. Vaatii käyttäjätunnuksen freemail.fi-sähköpostipalvelussa [https://freemail.fi]

Jos ehdit jo tehdä tunnuksen matrix.org:iin, voit [https://ems.element.io/tools/matrix-migration tällä työkalulla] siirtää tietosi uudelle palvelimelle.

Oman Matrix-kotipalvelimen ylläpitäminen on myös kohtuullisen helppoa ja vertautuu muiden palvelinten pyörittämiseen.

== Suomenkielisiä Matrix-huoneita ==

Liity esim kirjoittamalla '''/join #kanava:palvelin'''

Jos tiedät IRC-kanavan jolle haluat liittyä, liity kanavalle '''#_ircnet_#kanava:irc.snt.utwente.nl''' (IRCNet)
tai '''#freenode_#kanava:matrix.org''' (freenode). Muut verkot löytyy [https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks täältä].

Valtaosa suomenkielisistä Matrix-kanavista on sillattu vastaavalle IRC-kanavalle.

=== Tekniikka ja tiede ===

* #matrix.fi:matrix.org - Suomalaiset Matrix-käyttäjät, apua ja vertaistukea Matrixin käyttöön
* #linux.fi:linux.fi - Linux.fi
* #lennokit:matrix.org - Lennokki- ja kopteriharrastajat
* #tietokonelaitteistot:matrix.org - Tietokonelaitteisiin liittyvä keskustelu
* #amigafin:hacklab.fi - Amigaharrastajat
* #rintamamiestalo:hacklab.fi - Rintamamiestalojen omistajien tukiryhmä
* #fediversumi:kapsi.fi - Keskustelua federoiduista verkkopalveluista
* #vr-harrastajat:hacklab.fi - Keskustelua virtuaalitodellisuuslaittista ja softista
* #sysadm.fi:hacklab.fi - Palvelinten ylläpitäjät
* #ohjelmointi:hacklab.fi - Keskustelua ohjelmoinnista eri kielillä
* #avoindata:hacklab.fi - Keskustelua avoimesta datasta
* #elektroniikka:hacklab.fi - Elektroniikka
* #hamit:hacklab.fi - Radioamatöörit
* #Teollinen_IoT:hacklab.fi - Keskustelua teollisesta internet of thingsistä

=== Taide ja kulttuuri ===

* #turunsyntetisaattoriseura:matrix.org - Turun syntetisaattoriseura (oikeasti globaali ja kaikille avoin)
* #skrolli:hacklab.fi - Skrolli -lehti (tietokonekulttuurin erikoislehti) [https://skrolli.fi/ WWW-sivut]
* #suomiscene:hacklab.fi - Demoscene -harrastajat
* #wappuradio:hacklab.fi - Rakkauden Wappuradio (Tamperelainen opiskelijaradio, IRCNetin ison kanava joka ei liity waretukseen) [https://wappuradio.fi/ Radion WWW-sivut]
* #kirjasuositukset:kapsi.fi - Keskustelua kirjoista
* #hakkeriradio:hacklab.fi - Hakkeriradio - erikoistunut elektroniseen musiikkiin ja digitaalisen maailman ilmiöihin. [https://hakkeriradio.fi/ Radion WWW-sivut]
* #kovaydin:hacklab.fi - Kovaydin.NET on nettiyhteisö, bilejärjestö, nettilafka ja elektronisen underground *core-musiikin sanansaattaja Suomessa [https://kovaydin.net/ WWW-sivut]
* #sslnr:hacklab.fi - Suomalaiset spiikatut livenettiradiot. Täällä voi mainostaa ja linkata suomeksi puhuttuja, livenä tulevia nettiradioita ja videostriimejä.
* #rattoradio:hacklab.fi - Oululainen opiskelijoiden wappuradio.

=== Yhteisöt ===

* #general:hacklab.fi - Suomen hacklabien yhteiskanava (yksittäisillä labeilla on omansa)
* #kuppilatiima:hacklab.fi - Ilmailu, eri lajit, harrastajia ja ammattilaisia
* #sirius:hacklab.fi - Tähtitiede ja avaruus
* #taivaanvahti:hacklab.fi - Taivaanvahti -palvelun havaintoraportit
* #pyoraily:hacklab.fi - Polkupyöräily sähköllä tai ilman
* #yksivaihde:hacklab.fi - Fiksipyöräily

=== Pelit ===

* #warbirds:hacklab.fi - Virtuaalilentäjät (virtuaali-ilmailua, ilmailu & sotahistoriaa - IL2-sarja, DCS, X-Plane, jne)
* #condorsuomi:matrix.org - Condor-purjelentosimulaattori
* #freeciv.fi:ellipsis.fi - [http://freeciv.org Freeciv], vapaa Civilization-klooni

=== Paikalliset ===

* #tampere:matrix.org - Tampere

== Muun kielisiä vapaaohjelma-aiheisia huoneita ==

* #fosdem:fosdem.org - [[FOSDEM]]-konferenssin pääasiallinen keskusteluhuone
* #revision:hacklab.fi - [https://revision-party.net/ Revision-demopartyt]

== Ohjeita ==

* [[Matrix-IRC|Matrix-IRC-siltaus]]
* [[Matrix-Telegram|Matrix-Telegram-siltaus]]
* [[Matrix-Discord|Matrix-Discord-siltaus]]

==Katso myös==

* [https://matrix.org Matrixin verkkosivut ]
* [https://app.element.io/ Elementin, web-pohjaisen Matrix-asiakasohjelman, kirjautumissivu]

[[Luokka:Pikaviestimet]]
[[Luokka:Verkko]]