How-to.md

@@ -0,0 +1,45 @@
+## How to use XMPP (jabber)
+
+In this walkthrough we shall deal with how you might go about registering with and connecting to an XMPP server.
+
+### Get yourself a client
+There are many to choose from, depending on your platform.
+Check out our [Chat Clients](https://unite.openworlds.info/Open-Media-Network/xmpp/wiki/Chat-Clients) page if you haven't already.
+
+In this example, we shall use [Gajim](https://gajim.org/download/) on Linux.
+The download page has good links for Installation instructions for many linux distributions.
+There is also an installer for Windows, and a [guide](https://dev.gajim.org/gajim/gajim/-/wikis/help/Gajim-on-macOS) for usge on MacOS.
+
+### Enable OMEMO
+OMEMO is used by Gajim (and some other clients) for end-to-end encryption.
+If required separately in your OS, make sure it gets installed as well.
+
+- Open Gajim
+- Goto menu 'Gajim > Plugins'
+- Goto 'Available' tab
+    - Mark the OMEMO plugin for "Install"
+    - Click 'Install/Update' button
+- Goto 'Installed' tab
+- Activate 'OMEMO'
+- Close to save the settings
+- Restart Gajim (not sure if necessary)
+
+### Register an account somewhere
+We shall use our server in this example.
+
+- Click menu 'Accounts > Modify Account ...'
+- Click 'Add Account' button
+- Enter details as follows (the server is part of the username):
+    - Username: `<username>@chat.openworlds.info`
+    - Password: `<we recommend a passphrase, or use of a password manager>`
+- Click 'Sign Up' button
+    - If you have an existing jabber account on another server, you can 'Log In' instead
+
+### Connect
+Connection from this point on should be automatic.
+Feel free to explore the preferences and config, and adapt to your needs.
+
+### Further Gajim help
+https://dev.gajim.org/gajim/gajim/-/wikis/help/Help
+
+Or more generally, the [wiki](https://dev.gajim.org/gajim/gajim/-/wikis/home) itself.