Jump to content

Matrix: Difference between revisions

From KDE Community Wiki
← Older edit
Update how to join IRC room
m →Distributions: Add KDE Linux
 
(94 intermediate revisions by 19 users not shown)
Line 1: Line 1:
KDE is officially using Matrix for collaboration within the community, superseding more antiquated and closed-source services.
KDE is officially using [https://www.matrix.org Matrix] for collaboration within the community. Matrix is an open protocol and network for decentralized communication. It provides all the features you would expect from a modern chat system: infinite scrollback, file transfer, typing notifications, read receipts, etc. It even provides end-to-end encryption for privacy (for private conversations).


[https://www.matrix.org Matrix] is an open protocol and network for decentralized communication, backed by an open standard and open source reference implementations for servers, clients, client SDKs, bridges, bots and more. It provides all the features you would expect from a modern chat system: infinite scrollback, file transfer, typing notifications, read receipts, presence, search, push notifications, stickers, VoIP calling and conferencing, etc.  It even provides end-to-end encryption (based on Signal’s double ratchet algorithm) for when you want some privacy.
Furthermore, Matrix natively supports bridges to other protocols, such as IRC where KDE also has channels. This means that you can use a Matrix client to join and use IRC channels as if they were Matrix rooms.


Furthermore, Matrix natively supports bridges to other protocols, such as IRC (the official KDE messaging channel). This means that you can use a Matrix client to join and use IRC channels like if they were Matrix rooms.
== Getting Started ==


{{Tip|If you'd rather skip reading this long wiki page and just want to start with a list of popular and common matrix rooms, you'll be interested in the [https://matrix.to/#/!OTxETzuhBDbnPqBqbP:kde.org KDE Matrix Space] available at [https://webchat.kde.org/#/room/#kde-community:kde.org #kde-community:kde.org]!}}
See the [https://matrix.org/try-matrix/ "Try Matrix" page] created by the Matrix Foundation, which has a walk-through of how to start chatting with Matrix.  


== General Concepts ==
While registrations on the KDE Matrix homeserver are '''closed''', you can register on '''any Matrix homeserver''' and you will be able to talk to anyone using Matrix.


Matrix is a federated network, meaning anyone can host their own Matrix server (that is, a homeserver) and have it communicate with other Matrix servers. To register an account, you first need to find a suitable homeserver. The [https://app.element.io/#/welcome matrix.org homeserver] is the most popular one, and KDE provides its own homeserver too, [https://webchat.kde.org/#/welcome kde.org].  
You should pick a homeserver from this [https://joinmatrix.org/servers/ list of public homeservers]. The [https://app.element.io/#/register official matrix.org homeserver] is also available, but it will be slower due to its high number of users.


You do not need to create an account in the same homeserver a room is in to access it, e.g. creating an account on matrix.org doesn't stop you from visiting rooms in kde.org.
After registration you may use any Matrix website to log in, but KDE provides an instance of Element Web hosted at [https://webchat.kde.org webchat.kde.org] ('''Registering an account here is disabled, create an account from other webserver and login here''') that you can use anytime to log in, no matter where you registered your account.


The KDE homeserver is temporarily closed for registration. You may register on [https://app.element.io/#/welcome matrix.org] or search for another homeserver, a good resource to check is the [https://joinmatrix.org/ public list of Matrix homeservers]. It is not a comprehensive list, so you might find other interesting homeservers elsewhere.
To log in to the KDE Matrix Webchat with an account from a different homeserver, use your full '''''@username:homeserver.com''''' instead of your plain username, like so:
 
When you first create your account, you will be asked to provide a username. That username is then used to assign you a full username, which typically looks like this:


:@johndoe:matrix.org
:@johndoe:matrix.org


The text that comes immediately after the @ is your user, in this case, johndoe. The text that comes immediately after the : is the homeserver, matrix.org.
You may also use any [https://matrix.org/ecosystem/clients/ desktop or mobile Matrix client]. KDE provides a Matrix client that you can use called [https://apps.kde.org/neochat/ NeoChat].


Rooms follow a similar notation, but with #:
== Support for KDE Matrix servers ==


:<nowiki>#someroom:kde.org</nowiki>
You can ask questions related to Matrix over the [https://go.kde.org/matrix/#/#kde-matrix-support:kde.org #kde-matrix-support:kde.org] room. If you need help with the IRC integration in Matrix, see the [[Matrix/IRC Help]] page.


Matrix also has the concept of [https://element.io/blog/spaces-blast-out-of-beta/ Spaces]. They work as a sort of aggregation of rooms, all under the same space, hence the name. By joining [https://matrix.to/#/!OTxETzuhBDbnPqBqbP:kde.org KDE's Space], you will find the whole list of KDE rooms available to you directly from the main screen in your Matrix client (if the client supports it), and you'll be free to join the rooms you want to check out. This makes for a very easy way to discover and manage your list of rooms, especially if you are on a different homeserver!
== Space home ==


== Clients ==
If your Matrix client supports browsing spaces (like Element) then you can join the [https://go.kde.org/matrix/#/#kde-community:kde.org KDE Community Matrix space home]. Here you can see and search the list of Matrix rooms and spaces from the KDE Community.
You can chat using your web browser by visiting [https://webchat.kde.org KDE's webchat] or the [https://app.element.io/#/welcome Matrix webchat], alternatively you can use a desktop or mobile client to log in to your account. [https://matrix.org/clients/ Check out a list of clients for your desktop or mobile devices].


KDE also features its own native Matrix client, [https://apps.kde.org/neochat/ NeoChat].
== Rooms ==
 
== Registering and Logging in ==
 
==== On the web ====
'''THIS IS THE RECOMMENDED WAY OF REGISTERING YOUR ACCOUNT.'''
 
Registration on the kde.org server is temporarily disabled, even if you plan on using a desktop or mobile client later, [https://app.element.io/#/register register through the Matrix web chat] (or any other Matrix server). Even when registered in a different homeserver, you can still join the KDE Community web chat through there.
 
# Visit [https://app.element.io/#/register Element online web chat]
# Click the ''Create Account'' button. <br /> [[File:Riot upload 00.png|700px|center]]
# Choose a cool nickname and set your password. You can optionally include an email address if you ever need to recover your password. Click ''Register''. <br />[[File:Kde-register.png|666px|center]]
# Now that you are logged in, you may now join the [https://matrix.to/#/!OTxETzuhBDbnPqBqbP:kde.org #kde-community] space.
 
That's it! Now, you can connect to [https://webchat.kde.org KDE's online webchat] and can start chatting with members of KDE's community.
 
==== Using the Element desktop client ====
 
You may download the desktop client [https://element.io/get-started from Element's website].
APT repositories with Debian/Ubuntu packages and a community-maintained flatpak on [https://flathub.org/apps/details/im.riot.Riot flathub] are also provided.
You can also choose the latest stable version number listed at [https://github.com/vector-im/element-web/releases/latest Element's GitHub releases page].
 
Registering here follows the same process as above.


'''Homeserver URL''': '''https://matrix-client.matrix.org'''
Here is a list of rooms maintained by the KDE Matrix Team or KDE-adjacent rooms.  


[[File:Web_registration_01.png|700px|center]]
You can use https://go.kde.org/matrix/ to create easy-to-use invite links (like these ↓) to :kde.org rooms.


==== Using the Element Client for Mobile ====
=== General ===


''Currently Element only supports having one account''
{| class="wikitable sortable"
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#new-contributors:kde.org KDE New Contributors] || Ask questions about contributing to KDE. Do you want to start contributing to KDE? Then this is the Matrix room for you.
|-
|[https://go.kde.org/matrix/#/#kde:kde.org KDE] || The KDE user support Matrix room.
|-
|[https://go.kde.org/matrix/#/#kde-eco:kde.org KDE Eco] || Join the KDE Eco discussions about sustainability and efficiency in software design.
|-
|[https://go.kde.org/matrix/#/#kde-docs:kde.org KDE Documentation] || Discuss and improve KDE's Documentation
|-
|[https://go.kde.org/matrix/#/#kde-offtopic:kde.org KDE User Chat (KDE Offtopic)] || Discuss topics that are outside the scope of other rooms with the KDE community
|}


Log in with either your username, email or phone under the '''I already have an account''' section. Make sure the homeserver on '''Where your conversations live''' points to '''matrix.org''', if you already have a kde.org home server account, make sure it it points to '''kde.org''' instead.
=== Plasma ===


[[File:Screenshot Riot.im kde settings.png|300px|center]]
{| class="wikitable sortable"
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#plasma:kde.org Plasma Desktop] || For discussions among Plasma Desktop developers.
|-
|[https://go.kde.org/matrix/#/#plasmamobile:kde.org Plasma Mobile] || Plasma Mobile developers, users and other interested people.
|}


===== Android =====
=== System/Frameworks ===
The Element client is available from [https://play.google.com/store/apps/details?id=im.vector.app Google Play] and [https://f-droid.org/en/packages/im.vector.app/ F-Droid].


===== iOS =====
{| class="wikitable sortable"
There is also [https://itunes.apple.com/us/app/vector.im/id1083446067 a client for iOS available from Apple's App Store].
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#kirigami:kde.org Kirigami] || QML based Convergent User Interface framework.
|-
|[https://go.kde.org/matrix/#/#kwin:kde.org KWin] || KWin development channel.
|-
|[https://go.kde.org/matrix/#/#kde-android:kde.org KDE  Android] || KDE software on Android.
|-
|[https://go.kde.org/matrix/#/#kde-maui:kde.org Maui Project] || A free and modular front-end framework for developing user experiences.
|-
|[https://go.kde.org/matrix/#/#KDE-Mac:kde.org KDE Mac] || KDE software on macOS,.
|-
|[https://go.kde.org/matrix/#/#kde-windows:kde.org KDE Windows] || KDE software on Windows.
|}


===== Plasma Mobile =====
=== Distributions ===
On Plasma Mobile you can use [https://apps.kde.org/neochat/ NeoChat].


== Rooms ==
{| class="wikitable sortable"
The following is a collection of active rooms where KDE development and other activities happen. Some rooms are more active than others and you're welcome to browse through them. We add new rooms as they are formed.
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#debian-kde:matrix.org Debian KDE] || KDE software on Debian.
|-
|[https://go.kde.org/matrix/#/#kde:fedoraproject.org Fedora KDE] || KDE software on Fedora.
|-
|[https://go.kde.org/matrix/#/#gentoo-kde:libera.chat Gentoo KDE] || KDE software on Gentoo.
|-
|[https://go.kde.org/matrix/#/#kaosx:kde.org KaOS] || KDE software on KaOS.
|-
|[https://go.kde.org/matrix/#/#kde-freebsd:kde.org KDE for FreeBSD] || KDE software on FreeBSD.
|-
|[https://go.kde.org/matrix/#/#kde-linux:kde.org KDE Linux] || KDE Linux.
|-
|[https://go.kde.org/matrix/#/#kde-neon:kde.org KDE neon Development] || KDE neon development.
|-
|[https://go.kde.org/matrix/#/#kde-neon-users:kde.org KDE neon Users] || User support for KDE neon.
|-
|[https://go.kde.org/matrix/#/#kubuntu:libera.chat Kubuntu] || KDE software on Kubuntu.
|-
|[https://go.kde.org/matrix/#/#kubuntu-es:libera.chat Kubuntu (Spanish Community)] || Spanish-speaking community on Kubuntu.
|-
|[https://go.kde.org/matrix/#/#mageia-kde:libera.chat Mageia] || KDE software on Mageia.
|-
|[https://go.kde.org/matrix/#/#opensuse-kde:kde.org openSUSE KDE] || KDE software on openSUSE.
|-
|[https://go.kde.org/matrix/#/#ubuntustudio:kde.org Ubuntu Studio] || Ubuntu Studio development.
|-
|[https://go.kde.org/matrix/#/#ubuntustudio-offtopic:kde.org Ubuntu Studio Café (offtopic)] || Off-topic Ubuntu Studio chat.
|}


==== Welcome ====
=== Development/Contributors ===
New to KDE? [https://webchat.kde.org/#/room/#kde-welcome:kde.org Start here and find out what this is all about].


==== General KDE channel ====
{| class="wikitable sortable"
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#kde-devel:kde.org KDE Development] || KDE developers discuss technical stuff here.
|-
|[https://go.kde.org/matrix/#/#visualdesigngroup:kde.org KDE Visual Design Group] || Visual designers and Graphic artists discuss the look and feel of KDE software here.
|-
|[https://go.kde.org/matrix/#/#kde-promo:kde.org KDE Promo] || The people from the work group that does promotion and communication with the outside world hang out here.
|-
|[https://go.kde.org/matrix/#/#kde-multimedia:kde.org KDE Multimedia] || KDE Multimedia developers.
|-
|[https://go.kde.org/matrix/#/#kde-www:kde.org KDE www] || Managing websites and displaying the best the KDE Community has to offer.
|-
|[https://go.kde.org/matrix/#/#kde-games:kde.org KDE Games] || For the suite of KDE games.
|-
|[https://go.kde.org/matrix/#/#kde-i18n:kde.org Localization] || The main localization team for all your translation needs.
|-
|[https://go.kde.org/matrix/#/#kde-bugs:kde.org KDE Bugsquad] || The main room for bug reporters, testers and triagers.
|-
|[https://go.kde.org/matrix/#/#flatpak:kde.org Packaging KDE Flatpaks] || To assist in packaging KDE apps as flatpaks.
|-
|[https://go.kde.org/matrix/#/#yocto:kde.org Packaging KDE on Yocto] || To assist in packaging KDE apps on Yocto.
|}


Share your experience with [https://webchat.kde.org/#/room/#kde:kde.org the KDE community].
=== Applications ===
 
==== Plasma ====
 
* Plasma Desktop: [https://webchat.kde.org/#/room/#plasma:kde.org Find out more about KDE's desktop environment here].
* Plasma Mobile: [https://webchat.kde.org/#/room/#plasmamobile:kde.org Plasma Mobile developers, users and other interested people]
 
==== System applications, frameworks and other operating systems ====
 
* [https://webchat.kde.org/#/room/#kirigami:kde.org Kirigami]
* [https://webchat.kde.org/#/room/#kwin:kde.org KWin]
* [https://webchat.kde.org/#/room/#kde-android:kde.org KDE Apps for Android]
* [https://webchat.kde.org/#/room/#kde-maui:kde.org Maui Project]
* [https://webchat.kde.org/#/room/#KDE-Mac:kde.org Homebrew KDE]
* [https://webchat.kde.org/#/room/#kde-windows:kde.org KDE Apps for Windows]
 
==== Distribution-centered KDE rooms ====
 
* [https://webchat.kde.org/#/room/#debian-kde:matrix.org Debian KDE]
* [https://webchat.kde.org/#/room/#fedora-kde:kde.org Fedora KDE]
* [https://webchat.kde.org/#/room/#gentoo-kde:libera.chat Gentoo KDE]
* [https://webchat.kde.org/#/room/#kaosx:kde.org KaOS]
* [https://webchat.kde.org/#/room/#kde-freebsd:kde.org KDE for FreeBSD]
* [https://webchat.kde.org/#/room/#kde-neon:kde.org KDE neon]
* [https://webchat.kde.org/#/room/#kde-neon-users:kde.org KDE neon (Offtopic Room)]
* [https://webchat.kde.org/#/room/#kubuntu:libera.chat Kubuntu]
* [https://webchat.kde.org/#/room/#kubuntu-es:libera.chat Kubuntu (Spanish Community)]
* [https://webchat.kde.org/#/room/#mageia-kde:libera.chat Mageia]
* [https://webchat.kde.org/#/room/#opensuse-kde:kde.org openSUSE KDE]
* [https://webchat.kde.org/#/room/#ubuntustudio:kde.org Ubuntu Studio]
* [https://webchat.kde.org/#/room/#ubuntustudio-offtopic:kde.org Ubuntu Studio (Offtopic Room)]
 
==== For (potential) contributors ====
 
* Development: [https://webchat.kde.org/#/room/#kde-devel:kde.org KDE developers discuss technical stuff here].
* VDG: [https://webchat.kde.org/#/room/#visualdesigngroup:kde.org Visual designers and Graphic artists discuss the look and feel of KDE software here].
* Promo: [https://webchat.kde.org/#/room/#kde-promo:kde.org The people from the work group that does promotion and communication with the outside world hang out  here].
* KDE Multimedia: [https://webchat.kde.org/#/room/#kde-multimedia:kde.org KDE Multimedia developers].
* KDE Web: [https://webchat.kde.org/#/room/#freenode_#kde-www:matrix.org Managing websites and displaying the best the KDE Community has to offer.]
* KDE Games: [https://webchat.kde.org/#/room/#kde-games:kde.org For the suite of KDE games]
* Localization: [https://webchat.kde.org/#/room/#kde-i18n:matrix.org The main localization team for all your translation needs].
* Bugsquad: [https://webchat.kde.org/#/room/#kde-bugs:kde.org The main room for bug reporters, testers and triagers].
* Flatpak packaging: [https://matrix.to/#/#flatpak:kde.org To assist in packaging KDE apps as flatpaks].
 
==== Applications ====


Here is a list of individual applications that have their own Matrix rooms:
Here is a list of individual applications that have their own Matrix rooms:


* Akonadi: [https://webchat.kde.org/#/room/#akonadi:kde.org The personal information management framework]
{| class="wikitable sortable"
* Amarok (still being ported): [https://webchat.kde.org/#/room/#amarok:libera.chat A classic music player]
!Name !! Description
* Artikulate: [https://webchat.kde.org/#/room/#kde-artikulate:kde.org Train your pronunciation!]
|-
* Basket: [https://webchat.kde.org/#/room/#basket:kde.org For discussing the multi-purpose note-taking application].
|[https://go.kde.org/matrix/#/#akonadi:kde.org Akonadi] || The personal information management framework.
* Calligra: [https://webchat.kde.org/#/room/#calligra:libera.chat Previously known as the KOffice Suite]
|-
* Cantor: [https://webchat.kde.org/#/room/#cantor:kde.org Frontend for mathematical software]
|[https://go.kde.org/matrix/#/#amarok:libera.chat Amarok] || A classic music player.
* GCompris: [https://webchat.kde.org/#/room/#gcompris:kde.org Educational software for children]
|-
* KDE Connect: [https://webchat.kde.org/#/room/#kdeconnect:kde.org Connects all your devices]
|[https://go.kde.org/matrix/#/#kde-artikulate:kde.org Artikulate] || Train your pronunciation!
* KDE Partition Manager: [https://webchat.kde.org/#/room/#partitionmanager:kde.org KDE Partition Manager and KPMcore].
|-
* KEXI: [https://webchat.kde.org/#/room/#kexi:libera.chat Manage your databases]
|[https://go.kde.org/matrix/#/#basket:kde.org Basket] || For discussing the multi-purpose note-taking application.
* KMyMoney: [https://webchat.kde.org/#/room/#kmymoney:libera.chat Manage your finances]
|-
* KPhotoAlbum: [https://webchat.kde.org/#/room/#kphotoalbum:kde.org Manage your photo collection]
|[https://go.kde.org/matrix/#/!CVVMLsSKrfMEEDpqpX:kde.org Calligra] || Previously known as the KOffice Suite.
* KStars: [https://webchat.kde.org/#/room/#kstars:kde.org View constellations from your computer]
|-
* Kalendar: [https://webchat.kde.org/#/room/#kalendar:kde.org A calendar application using Akonadi to sync with external services]
|[https://go.kde.org/matrix/#/#cantor:kde.org Cantor] || Frontend for mathematical software.
* Kate: [https://webchat.kde.org/#/room/#kate:libera.chat The advanced plain text editor]
|-
* Kdenlive: [https://webchat.kde.org/#/room/#kdenlive:kde.org The room where we discuss KDE's professional video editor].
|[https://go.kde.org/matrix/#/#plasma-discover:kde.org Discover] || KDE software center (app store).
* Kirogi: [https://webchat.kde.org/#/room/#kde-kirogi:kde.org Control drones]
|-
* Kontact: [https://webchat.kde.org/#/room/#kontact:kde.org The Akonadi-based PIM suite]
|[https://go.kde.org/matrix/#/#kde-fm:matrix.org Dolphin] || A file manager and KIO related subjects.
* Konversation: [https://webchat.kde.org/#/room/#konversation:matrix.org A user-friendly IRC client]
|-
* Latte Dock: [https://webchat.kde.org/#/room/#latte-dock:kde.org A dock for the masses]
|[https://go.kde.org/matrix/#/!UAzeNyDGGkyBQeudgQ:kde.org Elisa] || Simple music player aiming to provide a nice experience for its users.
* Marble: [https://webchat.kde.org/#/room/#marble:libera.chat The map/globe viewer with OpenStreetMap integration]
|-
* Okular: [https://webchat.kde.org/#/room/#okular:kde.org The most powerful OSS PDF reader]
|[https://go.kde.org/matrix/#/#gcompris:kde.org GCompris] || Educational software for children.
* Partition Manager: [https://webchat.kde.org/#/room/#partitionmanager:kde.org The official KDE partition manager]
|-
* Subtitle Composer: [https://webchat.kde.org/#/room/#subtitlecomposer:kde.org The configurable subtitle editor/translator]
|[https://go.kde.org/matrix/#/#kasts:kde.org Kasts] || Podcasts application for desktop and mobile.
* Yakuake: [https://webchat.kde.org/#/room/#yakuake:kde.org A fancy drop-down terminal]
|-
 
|[https://go.kde.org/matrix/#/#kdeconnect:kde.org KDE Connect] || Connects all your devices.
==== Events and goals ====
|-
 
|[https://go.kde.org/matrix/#/#partitionmanager:kde.org KDE Partition Manager] || KDE Partition Manager and KPMcore.
* [https://webchat.kde.org/#/room/#kde-soc:kde.org KDE Season of Code]
|-
* [https://webchat.kde.org/#/room/#kde-sod:kde.org KDE Season of Docs]
|[https://go.kde.org/matrix/#/#kexi:libera.chat KEXI] || Manage your databases.
* [https://webchat.kde.org/#/room/#kde-accessibility:kde.org KDE Accessibility]
|-
* [https://webchat.kde.org/#/room/#kde-quality:kde.org KDE Quality]
|[https://go.kde.org/matrix/#/#kmymoney:libera.chat KMyMoney] || Manage your finances.
* [https://webchat.kde.org/#/room/#kde-women:kde.org KDE Women]
|-
* [https://webchat.kde.org/#/room/#kde-edu:kde.org KDE EDU]
|[https://go.kde.org/matrix/#/#kphotoalbum:kde.org KPhotoAlbum] || Manage your photo collection.
* [https://webchat.kde.org/#/room/#akademy:kde.org Akademy]
|-
* [https://webchat.kde.org/#/room/#fosdem2020:kde.org FOSDEM 2020]
|[https://go.kde.org/matrix/#/#kstars:kde.org KStars] || View constellations from your computer.
* [https://webchat.kde.org/#/room/#kde-all-about-apps:kde.org KDE Goal: It's all about the apps]
|-
* [https://webchat.kde.org/#/room/#kde-is-privacy:kde.org KDE is Privacy]
|[https://go.kde.org/matrix/#/#kate:libera.chat Kate] || The advanced plain text editor.
 
|-
==== Local communities ====
|[https://go.kde.org/matrix/#/#kdenlive:kde.org Kdenlive] || The room where we discuss KDE's professional video editor.
 
|-
* [https://webchat.kde.org/#/room/#kde_ru:kde.org KDE Russia]
|[https://go.kde.org/matrix/#/#kde-kirogi:kde.org Kirogi] || Control drones.
* [https://webchat.kde.org/#/room/#kde-brasil:kde.org KDE Brazil]
|-
* [https://webchat.kde.org/#/room/#kdebrasil-traducao:kde.org KDE Brazil l10n]
|[https://go.kde.org/matrix/#/#kontact:kde.org Kontact] || The Akonadi-based PIM suite.
* [https://webchat.kde.org/#/room/#jp:kde.org KDE Japan]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-nl:matrix.org KDE Netherlands]
|[https://go.kde.org/matrix/#/#konversation:matrix.org Konversation] || A user-friendly IRC client.
* [https://webchat.kde.org/#/room/#freenode_#kde-be:matrix.org KDE Belgium]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-ir:matrix.org KDE Iran]
|[https://go.kde.org/matrix/#/#krita:kde.org Krita] || Professional painting program.
* [https://webchat.kde.org/#/room/#freenode_#kde-pt:matrix.org KDE Portugal]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-china:matrix.org KDE China]
|[https://go.kde.org/matrix/#/#labplot:kde.org LabPlot] || Data Visualization and Analysis
* [https://webchat.kde.org/#/room/#freenode_#kde-italia:matrix.org KDE Italia]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-de:matrix.org KDE Germany]
|[https://go.kde.org/matrix/#/#marble:libera.chat Marble] || The map/globe viewer with OpenStreetMap integration.
* [https://webchat.kde.org/#/room/#kde-el:kde.org KDE Greece]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-ar:matrix.org KDE Argentina]
|[https://go.kde.org/matrix/#/#marknote:kde.org Marknote] || A simple markdown note management app
* [https://webchat.kde.org/#/room/#freenode_#kdehispano:matrix.org KDE Spain]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-es:matrix.org KDE for spanish-speaking users]
|[https://go.kde.org/matrix/#/#neochat:kde.org NeoChat] || A Matrix client
* [https://webchat.kde.org/#/room/#freenode_#kde-latam:matrix.org KDE Latin America]
|-
* [https://webchat.kde.org/#/room/#freenode_#kde-fr:matrix.org KDE France]
|[https://go.kde.org/matrix/#/#okular:kde.org Okular] || The most powerful open-source PDF reader.
* [https://webchat.kde.org/#/room/#kde-francophone:kde.org KDE for french-speaking users]
|-
 
|[https://go.kde.org/matrix/#/#subtitlecomposer:kde.org Subtitle Composer] || The configurable subtitle editor/translator.
== How to Add Your Existing IRC Channel as Room ==
|-
 
|[https://go.kde.org/matrix/#/#yakuake:kde.org Yakuake] || A fancy drop-down terminal.
{{Note|1=This only needs to be done '''once''' by an IRC operator. After that all users may use the more convenient local room name to join.}}
|}
 
* /join  #_freenode_#YOUR_CHANNEL:kde.org
* On the IRC side you need to OP your matrix user, so either use a temporary nick on Matrix, or add multiple nicks to your IRC identity and use a different one on Matrix and IRC, or have a fellow OP give you OP privileges
* Setup a local alias for kde.org via the matrix room settings
* Leave room again
* Join via local alias e.g. /join #YOUR_CHANNEL
* Everyone can now join your room using the #YOUR_CHANNEL locally and #YOUR_CHANNEL:kde.org in Matrix
 
You can set up your alias depending on the client you choose. For webchat.kde.org it looks like this:
 
[[File:Riot-room-alias-1.png|500px|center]]
[[File:Riot-room-alias-2.png|500px|center]]
 
You may additionally want to mark the room as published in the directory (so one can search for it) and set the KDE flair +kde:kde.org (so a fancy KDE flair will get shown; currently not set up). Both settings on webchat.kde.org are immediately after the room settings where you created the local room alias.
 
[[File:Riot-room-flairs.png|500px|center]]
 
 
<br/>
=Frequently Asked Questions=
<br/>
 
== I already have an account in the default Matrix homeserver. How do I access the KDE server and rooms with it? ==
 
After logging in to Element, you can click the compass icon next to the search bar to open the Explore Rooms dialog, click on Matrix Rooms, Add New Server..., then just type "kde.org". Now you should be able to browse the list of rooms in the KDE homeserver.
 
== How do I create shareable links to Matrix rooms? ==
You can create shareable links by typing their full name in https://go.kde.org/matrix.
 
Alternatively, in the room settings, the Share Room option will generate a link similar to this:
 
:https://matrix.to/#/#someroom:somehomeserver.org
 
But when you're using KDE's Webchat, you might find it easier to simply copy the link that shows up when you visit a room, like the KDE Welcome one:
 
:https://webchat.kde.org/#/room/#kde-welcome:kde.org
 
== How does the IRC integration in Matrix compare with IrcsomeBot? ==
 
IrcsomeBot is a Telegram bot that can bridge a Telegram group with an IRC channel. However there are a few shortcomings:
 
* A KDE sysadmin needs to [https://community.kde.org/Infrastructure/IRC#Telegram_Bridge setup the bridge] between each room/channel. Matrix instead supports out of the box any freenode/libera.chat channel (and other IRC networks).
* IrcsomeBot is the only nickname that joins the IRC channel and forwards the messages sent from Telegram on behalf of their senders. Matrix instead performs native bridging between the two protocols and creates a real IRC user that joins the IRC channel. Other people will be able to keep the usual IRC workflow with your bridged nickname (<code>/whois</code>, <code>/query</code>, etc.). In fact, they won't even know that you are using the Matrix bridge instead of a classic IRC client.
 
== Why should I join IRC channels using Matrix? ==
 
Your IRC nickname will be available 24/7 and other people will be able to ping or contact you even if you are away from your computer. While this can also be achieved using an IRC bouncer, Matrix has several advantages over this:
 
* Matrix provides unlimited chat history, an IRC bouncer does not.
* The Matrix IRC bridge is much easier to setup than an IRC bouncer.
* The Matrix reference client [https://element.io/ (Element)] can be used from smartphones.
 
== How do I join an IRC channel using Matrix? ==
 
You can search or browse IRC channels from Element. Just type the name of the channel you want to join and you are done.
 
[[File:KDE Riot.png|700px|center]]
 
By default, Matrix rooms which have public addresses and were published in the homeserver will display the default address: <nowiki>#roomname:homeserver.org</nowiki>, even if they have an IRC bridge. Some of them have aliases with IRC channels: attempting to join <nowiki>#freenode_#kde-i18n:matrix.org</nowiki> or <nowiki>#kde-i18n:libera.chat</nowiki> will redirect you to <nowiki>#kde-i18n:kde.org</nowiki>, for instance.
 
== How do I change my IRC nickname? ==
 
By default, the IRC bridge will use your matrix display name to generate an IRC nickname (ending with <tt>-M</tt>). If you don't like the default nickname, you can change it by sending the following command to the <code>@freenode-irc:kde.org</code> bot (you will need first to start a private conversation with the bot):
 
<pre>
!nick <your_favorite_irc_nickname>
</pre>


== How do I join an IRC channel that requires registered nicknames? ==
=== Language Initiatives ===
Start by opening a direct chat with NickServ. For freenode, that's <code>@_freenode_NickServ:kde.org</code>. Then send it a message of format:
<pre>identify [<nickname>] <password></pre>
— where nickname is optional assuming you are identifying for your current nickname.


To make the bridge store your credentials and log in automatically, in direct chat with the <code>@freenode-irc:kde.org</code> you can use the <tt>!storepass <string></tt> command to save a string that is sent through the PASS command when your IRC-presence connects.
{| class="wikitable sortable"
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#kde-python:kde.org KDE Python] || For people looking into integrating KDE with Python.
|-
|[https://go.kde.org/matrix/#/#kde-rust:kde.org KDE Rust] || For people looking into integrating KDE with Rust.
|}


With freenode you can use:
=== Events/Goals ===
<pre>
!storepass nickname:password
</pre>


== How do I change my away status? ==
{| class="wikitable sortable"
!Name
|-
|[https://go.kde.org/matrix/#/#akademy:kde.org Akademy Attendees] ([https://go.kde.org/matrix/#/#attend-akademy:kde.org Akademy Space])
|-
|[https://go.kde.org/matrix/#/#energy-efficiency:kde.org KDE Energy Efficiency (KDE Eco)]
|-
|[https://go.kde.org/matrix/#/#kde-ev-fundraising:kde.org KDE e.V. Fundraising Working Group]
|-
|[https://go.kde.org/matrix/#/#kde-accessibility:kde.org KDE Accessibility]
|-
|[https://go.kde.org/matrix/#/#kde-all-about-apps:kde.org KDE Goal: It's all about the apps]
|-
|[https://go.kde.org/matrix/#/#kde-edu:kde.org KDE EDU]
|-
|[https://go.kde.org/matrix/#/#kde-mentorship:kde.org KDE Mentorship Programs]
|-
|[https://go.kde.org/matrix/#/#kde-is-privacy:kde.org KDE is Privacy]
|-
|[https://go.kde.org/matrix/#/#kde-quality:kde.org KDE Quality]
|-
|[https://go.kde.org/matrix/#/#kde-soc:kde.org KDE Season of Code]
|-
|[https://go.kde.org/matrix/#/#kde-sod:kde.org KDE Season of Docs]
|-
|[https://go.kde.org/matrix/#/#kde-women:kde.org KDE Women]
|-
|[https://go.kde.org/matrix/#/#kdeisinclusive:kde.org KDE Is Inclusive]
|}


The <code>@freenode-irc:kde.org</code> bot accepts raw IRC commands. To set the away status use:
=== Global Communities ===


<pre>
See [[Global_Communities|Global Communities]] for a list of communication channels, including Matrix, by community and language.
!cmd AWAY <away_message>
</pre>


for example:
== Reporting spam/trolls ==


<pre>
If you happen to encounter a spammer or troll in any of our groups, please report them:
!cmd AWAY Sleeping
</pre>


To remove the away status just use:
* To report a message, if you are a user from kde.org, use the Report button.
* To report a message, if you aren't a user from kde.org, ping one of our contributors.
* To report a user, contact the instance of the reported user. For example, for matrix.org, send an email to [email protected].


<pre>
== See also ==
!cmd AWAY
</pre>


== Other questions? ==
[[Infrastructure/Mailing-Lists|Mailing list (information)]]


[https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ Check out the FAQ maintained upstream].
== External links ==


You can also ask questions related to Matrix over the [https://webchat.kde.org/#/room/#kde-matrix-support:kde.org #kde-matrix-support] room.
[https://kde.org/support/mailinglists// Mailing lists]

Latest revision as of 04:48, 10 December 2024

KDE is officially using Matrix for collaboration within the community. Matrix is an open protocol and network for decentralized communication. It provides all the features you would expect from a modern chat system: infinite scrollback, file transfer, typing notifications, read receipts, etc. It even provides end-to-end encryption for privacy (for private conversations).

Furthermore, Matrix natively supports bridges to other protocols, such as IRC where KDE also has channels. This means that you can use a Matrix client to join and use IRC channels as if they were Matrix rooms.

Getting Started

See the "Try Matrix" page created by the Matrix Foundation, which has a walk-through of how to start chatting with Matrix.

While registrations on the KDE Matrix homeserver are closed, you can register on any Matrix homeserver and you will be able to talk to anyone using Matrix.

You should pick a homeserver from this list of public homeservers. The official matrix.org homeserver is also available, but it will be slower due to its high number of users.

After registration you may use any Matrix website to log in, but KDE provides an instance of Element Web hosted at webchat.kde.org (Registering an account here is disabled, create an account from other webserver and login here) that you can use anytime to log in, no matter where you registered your account.

To log in to the KDE Matrix Webchat with an account from a different homeserver, use your full @username:homeserver.com instead of your plain username, like so:

@johndoe:matrix.org

You may also use any desktop or mobile Matrix client. KDE provides a Matrix client that you can use called NeoChat.

Support for KDE Matrix servers

You can ask questions related to Matrix over the #kde-matrix-support:kde.org room. If you need help with the IRC integration in Matrix, see the Matrix/IRC Help page.

Space home

If your Matrix client supports browsing spaces (like Element) then you can join the KDE Community Matrix space home. Here you can see and search the list of Matrix rooms and spaces from the KDE Community.

Rooms

Here is a list of rooms maintained by the KDE Matrix Team or KDE-adjacent rooms.

You can use https://go.kde.org/matrix/ to create easy-to-use invite links (like these ↓) to :kde.org rooms.

General

Name Description
KDE New Contributors Ask questions about contributing to KDE. Do you want to start contributing to KDE? Then this is the Matrix room for you.
KDE The KDE user support Matrix room.
KDE Eco Join the KDE Eco discussions about sustainability and efficiency in software design.
KDE Documentation Discuss and improve KDE's Documentation
KDE User Chat (KDE Offtopic) Discuss topics that are outside the scope of other rooms with the KDE community

Plasma

Name Description
Plasma Desktop For discussions among Plasma Desktop developers.
Plasma Mobile Plasma Mobile developers, users and other interested people.

System/Frameworks

Name Description
Kirigami QML based Convergent User Interface framework.
KWin KWin development channel.
KDE Android KDE software on Android.
Maui Project A free and modular front-end framework for developing user experiences.
KDE Mac KDE software on macOS,.
KDE Windows KDE software on Windows.

Distributions

Name Description
Debian KDE KDE software on Debian.
Fedora KDE KDE software on Fedora.
Gentoo KDE KDE software on Gentoo.
KaOS KDE software on KaOS.
KDE for FreeBSD KDE software on FreeBSD.
KDE Linux KDE Linux.
KDE neon Development KDE neon development.
KDE neon Users User support for KDE neon.
Kubuntu KDE software on Kubuntu.
Kubuntu (Spanish Community) Spanish-speaking community on Kubuntu.
Mageia KDE software on Mageia.
openSUSE KDE KDE software on openSUSE.
Ubuntu Studio Ubuntu Studio development.
Ubuntu Studio Café (offtopic) Off-topic Ubuntu Studio chat.

Development/Contributors

Name Description
KDE Development KDE developers discuss technical stuff here.
KDE Visual Design Group Visual designers and Graphic artists discuss the look and feel of KDE software here.
KDE Promo The people from the work group that does promotion and communication with the outside world hang out here.
KDE Multimedia KDE Multimedia developers.
KDE www Managing websites and displaying the best the KDE Community has to offer.
KDE Games For the suite of KDE games.
Localization The main localization team for all your translation needs.
KDE Bugsquad The main room for bug reporters, testers and triagers.
Packaging KDE Flatpaks To assist in packaging KDE apps as flatpaks.
Packaging KDE on Yocto To assist in packaging KDE apps on Yocto.

Applications

Here is a list of individual applications that have their own Matrix rooms:

Name Description
Akonadi The personal information management framework.
Amarok A classic music player.
Artikulate Train your pronunciation!
Basket For discussing the multi-purpose note-taking application.
Calligra Previously known as the KOffice Suite.
Cantor Frontend for mathematical software.
Discover KDE software center (app store).
Dolphin A file manager and KIO related subjects.
Elisa Simple music player aiming to provide a nice experience for its users.
GCompris Educational software for children.
Kasts Podcasts application for desktop and mobile.
KDE Connect Connects all your devices.
KDE Partition Manager KDE Partition Manager and KPMcore.
KEXI Manage your databases.
KMyMoney Manage your finances.
KPhotoAlbum Manage your photo collection.
KStars View constellations from your computer.
Kate The advanced plain text editor.
Kdenlive The room where we discuss KDE's professional video editor.
Kirogi Control drones.
Kontact The Akonadi-based PIM suite.
Konversation A user-friendly IRC client.
Krita Professional painting program.
LabPlot Data Visualization and Analysis
Marble The map/globe viewer with OpenStreetMap integration.
Marknote A simple markdown note management app
NeoChat A Matrix client
Okular The most powerful open-source PDF reader.
Subtitle Composer The configurable subtitle editor/translator.
Yakuake A fancy drop-down terminal.

Language Initiatives

Name Description
KDE Python For people looking into integrating KDE with Python.
KDE Rust For people looking into integrating KDE with Rust.

Events/Goals

Name
Akademy Attendees (Akademy Space)
KDE Energy Efficiency (KDE Eco)
KDE e.V. Fundraising Working Group
KDE Accessibility
KDE Goal: It's all about the apps
KDE EDU
KDE Mentorship Programs
KDE is Privacy
KDE Quality
KDE Season of Code
KDE Season of Docs
KDE Women
KDE Is Inclusive

Global Communities

See Global Communities for a list of communication channels, including Matrix, by community and language.

Reporting spam/trolls

If you happen to encounter a spammer or troll in any of our groups, please report them:

  • To report a message, if you are a user from kde.org, use the Report button.
  • To report a message, if you aren't a user from kde.org, ping one of our contributors.
  • To report a user, contact the instance of the reported user. For example, for matrix.org, send an email to [email protected].

See also

Mailing list (information)

External links

Mailing lists

Retrieved from "https://community.kde.org/index.php?title=Matrix&oldid=102386"