diff --git a/How-to.md b/How-to.md new file mode 100644 index 0000000..9d00ded --- /dev/null +++ b/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: `@chat.openworlds.info` + - Password: `` +- 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. \ No newline at end of file