#language de
#acl Known:read,write,delete,revert All:read


<<TableOfContents()>>

[[https://matrix.org|Matrix]] ist ein dezentraler Kommunikationsdienst. Wir verwenden eine lokale Instanz für die  Kommunikation im Hackspace und mit Interessierten. Der von uns betriebene Web-Client [[https://element.io/|element]] ist unter [[https://quassel.hack-hro.de/|quassel.hack-hro.de]] erreichbar.

Die ersten Schritte der Nutzung sind unter [[#Erstanmeldung|Erstanmeldung]] beschrieben.

= Clients =

Der einfachste Weg zum Zugriff auf den Matrix-Dienst dürfte der von uns gehostete Web-Client ''element'' sein: [[https://quassel.hack-hro.de|quassel.hack-hro.de]].

Alternativ sind eine Reihe von Clients für Mobilgeräte oder ähnliches verfügbar: [[https://matrix.org/clients/|Matrix-Clients]].

= Tipps zur Nutzung =

== Erstanmeldung ==

Bei der ersten Anmeldung beim Matrix-Server wird der Account und der dazugehörige Account-Schlüssel erzeugt. Für diesen Schlüssel musst du ein Passwort festlegen (siehe oben: Schlüsselpasswort). Anschließend wird dir eine Wiederherstellungspassphrase angezeigt. Beide Informationen musst du sicher irgendwo ablegen. Andernfalls kannst du dich später nicht mit weiteren Devices (siehe oben) mit dem Matrix-Server verbinden. Diese beiden Informationen sind privat und können bei Verlust auch von den Administratoren des Diensts nicht wiederhergestellt werden.

Anschließend kannst du individuelle Gespräche mit Menschen beginnen ({{{+}}} neben Direktnachrichten) oder bestehenden Räumen beitreten (''Erkunde'').

Im Falle von Schwierigkeiten kannst du im Raum {{{#matrix:hack-hro.de}}} deine Mitmenschen um Rat fragen.

== Selbstgewählten Stickerpicker konfigurieren ==

Sticker sind Bilder, die als Ergänzung zu den normalerweise vorhandenen Emojis dienen. Oft werden Cartoon-Charaktere dargestellt. Zur Auswahl und zum Senden von Stickern muss ein Stickerpicker-Widget verwendet werden, welches von einem externen Server geladen werden muss. Wie die meisten Widgets wird es standardmäßig vom Integrationsserver (also entweder [[https://scalar.vector.im|Scalar]] oder einer eigenen [[https://github.com/turt2live/matrix-dimension|Dimension]]-Instanz) geladen. Es lässt sich aber vom Nutzer auch frei mittels eines speziellen Matrix-Account-State-Events ({{{m.widgets}}}) einstellen, um es von einem anderen Server zu laden. Für diesen Zweck gibt es eine JavaScript-Software namens [[https://github.com/maunium/stickerpicker|Stickerpicker]].

Stickerpicker bietet einige [[https://github.com/maunium/stickerpicker#comparison-with-other-sticker-pickers|Vorteile]] gegenüber den Widgets von Scalar und Dimension.

Auswahl eines externen Stickerpickers für den eigenen Account:

 1. In Element Desktop/Web die Devtools öffnen. Am einfachsten geht das, in dem man in einem beliebigem Raum {{{/devtools}}} an die Adresszeile anhängt.
1. Auf {{{Explore Account Data}}} klicken.
1. Auf {{{m.widgets}}} klicken.
1. Auf {{{Edit}}} klicken.
1. Den folgenden Inhalt in die Datei einfügen, eventuell die Beispiel-URL durch eine eigene ersetzen (oder auch nicht; die Instanz existiert und ist frei [[https://fantasycookie17.onederfultech.com/posts/2020/10/a-note-on-the-services-i-offer.html|nutzbar]]), ebenso {{{@ich:hack-hro.de}}} durch die eigene MXID (Matrix ID; {{{@name:hack-hro.de}}}) ersetzen ([[https://github.com/maunium/stickerpicker/wiki/Enabling-the-widget|Quelle]]):

{{{
{
    "stickerpicker": {
        "content": {
            "type": "m.stickerpicker",
            "url": "https://fantasycookie17.onederfultech.com/services/stickerpicker/?theme=$theme",
            "name": "Stickerpicker",
            "data": {}
            },
        "sender": "@ich:hack-hro.de",
        "state_key": "stickerpicker",
        "type": "m.widget",
        "id": "stickerpicker"
        }
}
}}}

Der Stickerpicker sollte sofort funktionieren. Falls nicht, dann eventuell den Client neu laden.

Anstelle des obigen Stickerpicker-Servers kannst du auch [[https://github.com/maunium/stickerpicker/wiki/Creating-packs|einen eigenen betreiben]] und mit deinen Lieblingsbildern ausstatten.

Weitere Ressourcen:

 * Deutschprachige Hilfe zu Matrix allgemein: [[https://matrix.to/#/#matrix:hack-hro.de|#matrix:hackhro.de]]
 * Stickerpicker-spezifischen Support auf Englisch: [[https://matrix.to/#/#stickerpicker:maunium.net|#stickerpicker:maunium.net]]
 * Sticker ausprobieren: in einem der beiden obigen Räume oder [[https://matrix.to/#/#test:matrix.org|#test:matrix.org]]