Matrix: Difference between revisions
Thiagosueto (talk | contribs) mNo edit summary |
m (Fix broken link) |
||
(8 intermediate revisions by 5 users not shown) | |||
Line 20: | Line 20: | ||
That's it! You can start chatting with members of KDE's community. | That's it! You can start chatting with members of KDE's community. | ||
==== Using the | ==== Using the Element desktop client ==== | ||
Download the desktop client [https:// | Download the desktop client [https://element.io/get-started from Element's website]. APT repositories with Debian/Ubuntu packages are provided. Your mileage may vary for other distributions. The latest stable version number is listed on [https://github.com/vector-im/element-web/releases/latest Element's GitHub releases page] and is the version number you should aim for. | ||
Registration is the same process as the steps above. Make sure you select Premium hosting and input https://kde.modular.im as the Server Name if you would like a Matrix account on KDE's Modular homeserver. | Registration is the same process as the steps above. Make sure you select Premium hosting and input https://kde.modular.im as the Server Name if you would like a Matrix account on KDE's Modular homeserver. | ||
Line 28: | Line 28: | ||
[[File:Web_registration_01.png|300px|center]] | [[File:Web_registration_01.png|300px|center]] | ||
==== Using the | ==== Using the Element client for mobile ==== | ||
''Currently | ''Currently Element only supports having one account'' | ||
In Signin/Register select the ''Use custom server options (Advanced)'' option to set the following | In Signin/Register select the ''Use custom server options (Advanced)'' option to set the following | ||
Line 40: | Line 40: | ||
===== Android ===== | ===== Android ===== | ||
The | 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 ===== | ===== iOS ===== | ||
Line 55: | Line 55: | ||
=== General KDE channel === | === General KDE channel === | ||
Share your experience with [https://webchat.kde.org/#/room/#kde:kde.org the KDE community]. | Share your experience with [https://webchat.kde.org/#/room/#kde:kde.org the KDE community]. | ||
=== Plasma === | === Plasma === | ||
* Plasma Desktop: [https://webchat.kde.org/#/room/#plasma:kde.org Find out more about KDE's desktop environment here]. | * 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] | * 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 === | |||
* Kirigami: [https://webchat.kde.org/#/room/#kirigami:kde.org #kirigami:kde.org] – For developers that want to use our mobile-friendly toolkit in their applications and for (potential) contributors to Kirigami itself. | |||
* [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/#freenode_#kde-windows:matrix.org KDE Apps for Windows] | |||
=== Distribution-centered KDE rooms === | === Distribution-centered KDE rooms === | ||
* [https://webchat.kde.org/#/room/#fedora-kde:kde.org Fedora KDE user | |||
* [https://webchat.kde.org/#/room/#fedora-kde:kde.org Fedora KDE user] | |||
* [https://webchat.kde.org/#/room/#kde-neon:kde.org KDE neon user support channel] | * [https://webchat.kde.org/#/room/#kde-neon:kde.org KDE neon user support channel] | ||
* [https://webchat.kde.org/#/room/#opensuse-kde:kde.org openSUSE KDE | * [https://webchat.kde.org/#/room/#kde-neon-users:kde.org KDE neon offtopic room] | ||
* [https://webchat.kde.org/#/room/#opensuse-kde:kde.org openSUSE KDE] | |||
* [https://webchat.kde.org/#/room/#freenode_#kubuntu:matrix.org Kubuntu] | |||
* [https://webchat.kde.org/#/room/#freenode_#kubuntu-es:matrix.org Spanish Kubuntu community] | |||
* [https://webchat.kde.org/#/room/#ubuntustudio:kde.org Ubuntu Studio] | |||
* [https://webchat.kde.org/#/room/#ubuntustudio-offtopic:kde.org Ubuntu Studio offtopic room] | |||
* [https://webchat.kde.org/#/room/#freenode_#gentoo-kde:matrix.org Gentoo KDE] | |||
* [https://webchat.kde.org/#/room/#freenode_#kde-freebsd:matrix.org KDE for FreeBSD] | |||
* [https://webchat.kde.org/#/room/#kaosx:kde.org KaOS] | |||
* [https://webchat.kde.org/#/room/#freenode_#mageia-kde:matrix.org Mageia] | |||
* [https://webchat.kde.org/#/room/#freenode_#debian-kde:matrix.org Debian KDE] | |||
=== For (potential) contributors === | === For (potential) contributors === | ||
* Development: [https://webchat.kde.org/#/room/#kde-devel:kde.org KDE developers discuss technical stuff here]. | * Development: [https://webchat.kde.org/#/room/#kde-devel:kde.org KDE developers discuss technical stuff here]. | ||
* VDG: [https://webchat.kde.org/#/room/#kde-vdg:kde.org Visual designers and Graphic artists discuss the look and feel of KDE software here]. | * VDG: [https://webchat.kde.org/#/room/#kde-vdg: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]. | * 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 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.] | |||
* Localization: [https://webchat.kde.org/#/room/#kde-i18n:matrix.org The main localization team for all your translation needs]. | * Localization: [https://webchat.kde.org/#/room/#kde-i18n:matrix.org The main localization team for all your translation needs]. | ||
=== Applications === | === 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: | ||
* Multimedia: [https://webchat.kde.org/#/room/#kde-multimedia:kde.org For everything multimedia] | |||
* Games: [https://webchat.kde.org/#/room/#freenode_#kde-games:matrix.org For the suite of KDE games] | |||
* Kdenlive: [https://webchat.kde.org/#/room/#kdenlive:kde.org The room where we discuss KDE's professional video editor]. | * Kdenlive: [https://webchat.kde.org/#/room/#kdenlive:kde.org The room where we discuss KDE's professional video editor]. | ||
* KDE Partition Manager: [https://webchat.kde.org/#/room/#partitionmanager:kde.org KDE Partition Manager and KPMcore]. | * KDE Partition Manager: [https://webchat.kde.org/#/room/#partitionmanager:kde.org KDE Partition Manager and KPMcore]. | ||
* Basket: [https://webchat.kde.org/#/room/#basket:kde.org For discussing the multi-purpose note-taking application]. | |||
* Subtitle Composer: [https://webchat.kde.org/#/room/#subtitlecomposer:kde.org The configurable subtitle editor/translator] | |||
* Latte Dock: [https://webchat.kde.org/#/room/#latte-dock:kde.org A dock for the masses] | |||
* Artikulate: [https://webchat.kde.org/#/room/#kde-artikulate:kde.org Train your pronunciation!] | |||
* Cantor: [https://webchat.kde.org/#/room/#cantor:kde.org Frontend for mathematical software] | |||
* Kirogi: [https://webchat.kde.org/#/room/#kde-kirogi:kde.org Control drones] | |||
* Partition Manager: [https://webchat.kde.org/#/room/#partitionmanager:kde.org The official KDE partition manager] | |||
* Marble: [https://webchat.kde.org/#/room/#freenode_#marble:matrix.org The map/globe viewer with OpenStreetMap integration] | |||
* KPhotoAlbum: [https://webchat.kde.org/#/room/#kphotoalbum:kde.org Manage your photo collection] | |||
* Calligra: [https://webchat.kde.org/#/room/#freenode_#calligra:matrix.org Previously known as the KOffice Suite] | |||
* Yakuake: [https://webchat.kde.org/#/room/#yakuake:kde.org A fancy drop-down terminal] | |||
* GCompris: [https://webchat.kde.org/#/room/#freenode_#gcompris:matrix.org Educational software for children] | |||
* KMyMoney: [https://webchat.kde.org/#/room/#freenode_#kmymoney:matrix.org Manage your finances] | |||
* Amarok (still being ported): [https://webchat.kde.org/#/room/#freenode_#amarok:matrix.org A classic music player] | |||
* Okular: [https://webchat.kde.org/#/room/#freenode_#okular:matrix.org The most powerful OSS PDF reader] | |||
* KStars: [https://webchat.kde.org/#/room/#kstars:kde.org View constellations from your computer] | |||
* Akonadi: [https://webchat.kde.org/#/room/#freenode_#akonadi:matrix.org The personal information management framework] | |||
* Kontact: [https://webchat.kde.org/#/room/#kontact:kde.org The Akonadi-based PIM suite] | |||
* Konversation: [https://webchat.kde.org/#/room/#konversation:matrix.org A user-friendly IRC client] | |||
* Kate: [https://webchat.kde.org/#/room/#freenode_#kate:matrix.org The advanced plain text editor] | |||
* KEXI: [https://webchat.kde.org/#/room/#freenode_#kexi:matrix.org Manage your databases] | |||
=== Events and goals === | |||
* [https://webchat.kde.org/#/room/#freenode#kde-soc:matrix.org KDE Season of Code] | |||
* [https://webchat.kde.org/#/room/#kde-sod:kde.org KDE Season of Docs] | |||
* [https://webchat.kde.org/#/room/#freenode#kde-accessibility:matrix.org KDE Accessibility] | |||
* [https://webchat.kde.org/#/room/#freenode#kde-quality:matrix.org KDE Quality] | |||
* [https://webchat.kde.org/#/room/#freenode#kde-women:matrix.org KDE Women] | |||
* [https://webchat.kde.org/#/room/#kde-edu:kde.org KDE EDU] | |||
* [https://webchat.kde.org/#/room/#akademy:kde.org Akademy] | |||
* [https://webchat.kde.org/#/room/#fosdem2020:kde.org FOSDEM 2020] | |||
* [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] | |||
=== Local communities === | === Local communities === | ||
* [https://webchat.kde.org/#/room/#kde_ru:kde.org KDE Russia] | * [https://webchat.kde.org/#/room/#kde_ru:kde.org KDE Russia] | ||
* [https://webchat.kde.org/#/room/#kde-brasil:kde.org KDE Brazil] | * [https://webchat.kde.org/#/room/#kde-brasil:kde.org KDE Brazil] | ||
* [https://webchat.kde.org/#/room/#jp:kde.org KDE Japan] | |||
* [https://webchat.kde.org/#/room/#freenode_#kde-nl:matrix.org KDE Netherlands] | |||
* [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://webchat.kde.org/#/room/#freenode_#kde-pt:matrix.org KDE Portugal] | |||
* [https://webchat.kde.org/#/room/#freenode_#kde-china:matrix.org KDE China] | |||
* [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://webchat.kde.org/#/room/#kde-el:kde.org KDE Greece] | |||
* [https://webchat.kde.org/#/room/#freenode_#kde-ar:matrix.org KDE Argentina] | |||
* [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://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://webchat.kde.org/#/room/#kde-francophone:kde.org KDE for french-speaking users] | |||
== How to Add Your Existing IRC Channel as Room == | == How to Add Your Existing IRC Channel as Room == | ||
Line 110: | Line 186: | ||
* Matrix provides unlimited chat history, an IRC bouncer doesn't. | * Matrix provides unlimited chat history, an IRC bouncer doesn't. | ||
* The Matrix IRC bridge is much easier to setup than an IRC bouncer. | * The Matrix IRC bridge is much easier to setup than an IRC bouncer. | ||
* The Matrix reference client [https:// | * The Matrix reference client [https://element.io/ (Element)] can be used from smartphones. | ||
== How does it compare with IrcsomeBot? == | == How does it compare with IrcsomeBot? == | ||
Line 121: | Line 197: | ||
== How do I join an IRC channel? == | == How do I join an IRC channel? == | ||
You can search or browse IRC channels from | 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|500px|center]] | [[File:KDE Riot.png|500px|center]] | ||
Line 180: | Line 256: | ||
[https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ Check out the FAQ maintained upstream]. | [https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ Check out the FAQ maintained upstream]. | ||
You can also ask questions related to matrix in #kde-matrix-support / #kde-matrix-support:kde.org |
Revision as of 10:12, 27 August 2020
Matrix is an open standard for interoperable, decentralised, real-time communications. KDE is officially using Matrix for collaboration within the community, superseding more antiquated and closed source services. 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 (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.
Clients
You can chat using your web browser and visiting KDE's webchat or you can use a desktop or mobile client. Here is a list of clients for your desktop or mobile devices.
Registering and Logging in
On the web
THIS IS THE RECOMMENDED WAY OF REGISTERING YOUR ACCOUNT.
Even if you plan on using a desktop or mobile client later, register through the web chat since it uses all the correct defaults to get a :kde.org account.
- Visit KDE's online webchat
- Locate the Create Account button. Press it.
- Choose a cool nickname and set your password. You can include an email if you ever need to recover your password, but this is optional. Click Register.
Note: the dialog now includes a checkbox for agreement with the Privacy Policy and Terms and Conditions.
That's it! You can start chatting with members of KDE's community.
Using the Element desktop client
Download the desktop client from Element's website. APT repositories with Debian/Ubuntu packages are provided. Your mileage may vary for other distributions. The latest stable version number is listed on Element's GitHub releases page and is the version number you should aim for.
Registration is the same process as the steps above. Make sure you select Premium hosting and input https://kde.modular.im as the Server Name if you would like a Matrix account on KDE's Modular homeserver.
![](/images.community/thumb/f/fe/Web_registration_01.png/300px-Web_registration_01.png)
Using the Element client for mobile
Currently Element only supports having one account
In Signin/Register select the Use custom server options (Advanced) option to set the following
- Home server: https://kde.modular.im
- Identity server: https://vector.im
![](/images.community/thumb/a/a2/Screenshot_Riot.im_kde_settings.png/300px-Screenshot_Riot.im_kde_settings.png)
Android
The Element client is available from Google Play and F-Droid.
iOS
There is also a client for iOS available from Apple's App Store.
Plasma Mobile
Coming soon! ;-)
Rooms
Check back often as we will be adding new rooms as we go.
Welcome
New to KDE? Start here and find out what this is all about.
General KDE channel
Share your experience with the KDE community.
Plasma
- Plasma Desktop: Find out more about KDE's desktop environment here.
- Plasma Mobile: Plasma Mobile developers, users and other interested people
System applications, frameworks and other operating systems
- Kirigami: #kirigami:kde.org – For developers that want to use our mobile-friendly toolkit in their applications and for (potential) contributors to Kirigami itself.
- KWin
- KDE Apps for Android
- Maui Project
- Homebrew KDE
- KDE Apps for Windows
Distribution-centered KDE rooms
- Fedora KDE user
- KDE neon user support channel
- KDE neon offtopic room
- openSUSE KDE
- Kubuntu
- Spanish Kubuntu community
- Ubuntu Studio
- Ubuntu Studio offtopic room
- Gentoo KDE
- KDE for FreeBSD
- KaOS
- Mageia
- Debian KDE
For (potential) contributors
- Development: KDE developers discuss technical stuff here.
- VDG: Visual designers and Graphic artists discuss the look and feel of KDE software here.
- 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 Web: Managing websites and displaying the best the KDE Community has to offer.
- Localization: The main localization team for all your translation needs.
Applications
Here is a list of individual applications that have their own Matrix rooms:
- Multimedia: For everything multimedia
- Games: For the suite of KDE games
- Kdenlive: The room where we discuss KDE's professional video editor.
- KDE Partition Manager: KDE Partition Manager and KPMcore.
- Basket: For discussing the multi-purpose note-taking application.
- Subtitle Composer: The configurable subtitle editor/translator
- Latte Dock: A dock for the masses
- Artikulate: Train your pronunciation!
- Cantor: Frontend for mathematical software
- Kirogi: Control drones
- Partition Manager: The official KDE partition manager
- Marble: The map/globe viewer with OpenStreetMap integration
- KPhotoAlbum: Manage your photo collection
- Calligra: Previously known as the KOffice Suite
- Yakuake: A fancy drop-down terminal
- GCompris: Educational software for children
- KMyMoney: Manage your finances
- Amarok (still being ported): A classic music player
- Okular: The most powerful OSS PDF reader
- KStars: View constellations from your computer
- Akonadi: The personal information management framework
- Kontact: The Akonadi-based PIM suite
- Konversation: A user-friendly IRC client
- Kate: The advanced plain text editor
- KEXI: Manage your databases
Events and goals
- KDE Season of Code
- KDE Season of Docs
- KDE Accessibility
- KDE Quality
- KDE Women
- KDE EDU
- Akademy
- FOSDEM 2020
- KDE Goal: It's all about the apps
- KDE is Privacy
Local communities
- KDE Russia
- KDE Brazil
- KDE Japan
- KDE Netherlands
- KDE Belgium
- KDE Iran
- KDE Portugal
- KDE China
- KDE Italia
- KDE Germany
- KDE Greece
- KDE Argentina
- KDE Spain
- KDE for spanish-speaking users
- KDE Latin America
- KDE France
- KDE for french-speaking users
How to Add Your Existing IRC Channel as Room
- /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 via the #YOUR_CHANNEL locally and #YOUR_CHANNEL:kde.org in the Matrix
Where you can setup the alias depends on the client you use. For webchat.kde.org it'll look a bit like this:
![](/images.community/thumb/5/58/Riot-room-alias-1.png/300px-Riot-room-alias-1.png)
![](/images.community/thumb/3/3f/Riot-room-alias-2.png/300px-Riot-room-alias-2.png)
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.
![](/images.community/thumb/6/61/Riot-room-flairs.png/300px-Riot-room-flairs.png)
Why should I use the Matrix IRC bridge?
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. This can also be achieved by using an IRC bouncer, but Matrix has several advantages:
- Matrix provides unlimited chat history, an IRC bouncer doesn't.
- The Matrix IRC bridge is much easier to setup than an IRC bouncer.
- The Matrix reference client (Element) can be used from smartphones.
How does it compare with IrcsomeBot?
IrcsomeBot is a Telegram bot that can bridge a Telegram group with an IRC channel. However there are the following shortcomings:
- A KDE sysadmin needs to setup the bridge between each room/channel. Matrix instead supports out of the box any freenode channel (and also 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 a 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 (
/whois
,/query
, etc.). In fact, they won't even know that you are using the Matrix bridge instead of a classic IRC client.
How do I join an IRC channel?
You can search or browse IRC channels from Element. Just type the name of the channel you want to join and you are done.
![](/images.community/thumb/0/02/KDE_Riot.png/500px-KDE_Riot.png)
If your favorite matrix client doesn't have a similar feature, you can join any freenode channel by joining the following Matrix room:
#_freenode_#<irc_channel_name>:kde.org
For example, if you want to join the #kde-devel IRC channel, just type:
/join #_freenode_#kde-devel:kde.org
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 -M). If you don't like the default nickname, you can change it by sending the following command to the @freenode-irc:kde.org
bot (you will need first to start a private conversation with the bot):
!nick <your_favorite_irc_nickname>
How do I join an IRC channel that requires registered nicknames?
Start by opening a direct chat with NickServ. For freenode, that's @_freenode_NickServ:kde.org
. Then send it a message of format:
identify [<nickname>] <password>
— 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 @freenode-irc:kde.org
you can use the !storepass <string> command to save a string that is sent in PASS command when your IRC-presence connects.
With freenode you can use:
!storepass nickname:password
How do I change my away status?
The @freenode-irc:kde.org
bot accepts raw IRC commands. To set the away status use:
!cmd AWAY <away_message>
for example:
!cmd AWAY Sleeping
To remove the away status just use:
!cmd AWAY
Other questions?
Check out the FAQ maintained upstream.
You can also ask questions related to matrix in #kde-matrix-support / #kde-matrix-support:kde.org