Matrix: Difference between revisions

From KDE Community Wiki
(How to change the irc nickname)
(Add Documentation channel)
(238 intermediate revisions by 46 users not shown)
Line 1: Line 1:
[https://www.matrix.org Matrix] is an open standard for interoperable, decentralised, real-time communications. One of the most interesting features of Matrix is the native support for bridges to other protocols, such as IRC. This means that you can use a Matrix client to join and use IRC channels like if they were Matrix rooms.  
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).


== Why should I use the Matrix IRC bridge? ==
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.


Your IRC nickname will be available 24h and other people will be able to ping or contact you even if you are away from your computer. This can also be achieved by using an IRC bouncer, but Matrix has several advantages:
== Getting Started ==


* Matrix provides unlimited chat history, an IRC bouncer doesn't.
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.  
* The Matrix IRC bridge is much easier to setup than an IRC bouncer.
* The Matrix reference client [https://riot.im (Riot)] can be used from smartphones.


== How do I join an IRC channel? ==
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 can search or browse IRC channels from Riot. Just type the name of the channel you want to join and you are done.
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.


[[File:riot_freenode.png|500px|thumb|center]]
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.


If your favorite matrix client doesn't have a similar feature, you can join any freenode channel by joining the following Matrix room:
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:


<pre>
:@johndoe:matrix.org
#freenode_<irc_channel_name>:matrix.org
</pre>


For example, if you want to join the <tt>#kde-devel</tt> IRC channel, just type:
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].


<pre>
== Support for KDE Matrix servers ==
/join #freenode_#kde-devel:matrix.org
</pre>


== How do I change my IRC nickname? ==
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.


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>@appservice-irc:matrix.org</code> bot (you will need first to start a private conversation with the bot):
== Space ==


<pre>
If your Matrix client supports browsing spaces (like Element) then you can join the [https://go.kde.org/matrix/#/#kde-community:kde.org KDE Matrix Space] which lets you join it's rooms easily.
!nick <your_favorite_irc_nickname>
 
</pre>
== 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 ===
 
{| 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
|}
 
=== Plasma ===
 
{| 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.
|}
 
=== System/Frameworks ===
 
{| class="wikitable sortable"
!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.
|}
 
=== Distributions ===
 
{| class="wikitable sortable"
!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-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.
|}
 
=== Development/Contributors ===
 
{| 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:matrix.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.
|}
 
=== Applications ===
 
Here is a list of individual applications that have their own Matrix rooms:
 
{| class="wikitable sortable"
!Name !! Description
|-
|[https://go.kde.org/matrix/#/#akonadi:kde.org Akonadi] || The personal information management framework.
|-
|[https://go.kde.org/matrix/#/#amarok:libera.chat Amarok] || A classic music player.
|-
|[https://go.kde.org/matrix/#/#kde-artikulate:kde.org Artikulate] || Train your pronunciation!
|-
|[https://go.kde.org/matrix/#/#basket:kde.org Basket] || For discussing the multi-purpose note-taking application.
|-
|[https://go.kde.org/matrix/#/!CVVMLsSKrfMEEDpqpX:kde.org Calligra] || Previously known as the KOffice Suite.
|-
|[https://go.kde.org/matrix/#/#cantor:kde.org Cantor] || Frontend for mathematical software.
|-
|[https://go.kde.org/matrix/#/#plasma-discover:kde.org Discover] || KDE software centre.
|-
|[https://go.kde.org/matrix/#/#kde-fm:matrix.org Dolphin] || A file manager and KIO related subjects.
|-
|[https://go.kde.org/matrix/#/!UAzeNyDGGkyBQeudgQ:kde.org Elisa] || Simple music player aiming to provide a nice experience for its users.
|-
|[https://go.kde.org/matrix/#/#gcompris:kde.org GCompris] || Educational software for children.
|-
|[https://go.kde.org/matrix/#/#kdeconnect:kde.org KDE Connect] || Connects all your devices.
|-
|[https://go.kde.org/matrix/#/#partitionmanager:kde.org KDE Partition Manager] || KDE Partition Manager and KPMcore.
|-
|[https://go.kde.org/matrix/#/#kexi:libera.chat KEXI] || Manage your databases.
|-
|[https://go.kde.org/matrix/#/#kmymoney:libera.chat KMyMoney] || Manage your finances.
|-
|[https://go.kde.org/matrix/#/#kphotoalbum:kde.org KPhotoAlbum] || Manage your photo collection.
|-
|[https://go.kde.org/matrix/#/#kstars:kde.org KStars] || View constellations from your computer.
|-
|[https://go.kde.org/matrix/#/#kate:libera.chat Kate] || The advanced plain text editor.
|-
|[https://go.kde.org/matrix/#/#kdenlive:kde.org Kdenlive] || The room where we discuss KDE's professional video editor.
|-
|[https://go.kde.org/matrix/#/#kde-kirogi:kde.org Kirogi] || Control drones.
|-
|[https://go.kde.org/matrix/#/#kontact:kde.org Kontact] || The Akonadi-based PIM suite.
|-
|[https://go.kde.org/matrix/#/#konversation:matrix.org Konversation] || A user-friendly IRC client.
|-
|[https://go.kde.org/matrix/#/#krita:kde.org Krita] || Professional painting program.
|-
|[https://go.kde.org/matrix/#/#labplot:kde.org LabPlot] || Data Visualization and Analysis
|-
|[https://go.kde.org/matrix/#/#marble:libera.chat Marble] || The map/globe viewer with OpenStreetMap integration.
|-
|[https://go.kde.org/matrix/#/#marknote:kde.org Marknote] || A simple markdown note management app
|-
|[https://go.kde.org/matrix/#/#okular:kde.org Okular] || The most powerful open-source PDF reader.
|-
|[https://go.kde.org/matrix/#/#subtitlecomposer:kde.org Subtitle Composer] || The configurable subtitle editor/translator.
|-
|[https://go.kde.org/matrix/#/#yakuake:kde.org Yakuake] || A fancy drop-down terminal.
|}
 
=== Events/Goals ===
 
{| class="wikitable sortable"
!Name
|-
|[https://go.kde.org/matrix/#/#akademy:kde.org Akademy]
|-
|[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]
|}
 
=== Global Communities ===
 
See [[Global_Communities|Global Communities]] for a list of communication channels, including Matrix, by community and language.
 
== See also ==
 
[[Infrastructure/Mailing-Lists|Mailing list (information)]]
 
== External links ==
 
[https://kde.org/support/mailinglists// Mailing lists]

Revision as of 09:36, 11 September 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

If your Matrix client supports browsing spaces (like Element) then you can join the KDE Matrix Space which lets you join it's rooms easily.

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

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 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 centre.
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.
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
Okular The most powerful open-source PDF reader.
Subtitle Composer The configurable subtitle editor/translator.
Yakuake A fancy drop-down terminal.

Events/Goals

Name
Akademy
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.

See also

Mailing list (information)

External links

Mailing lists