Quickstart guide¶

This page is an attempt at providing first aid to new users, who must first follow the Install Guide to get a working poezio install.

Reading the more detailed Usage page is recommended to get a deeper understanding of poezio.

Anonymous usage¶

If you run poezio right after installing, you will get connected to the default anonymous server, which allows you to join rooms, and talk to people.

Joining rooms¶

The /join command allows you to join a chatroom and start talking to people right away. It opens a new Chatroom tab.

Talking to people¶

You can use the /message command if you know the address of people you want to talk to. This will open a Conversation tab.

Normal usage¶

In order to use an account, you have to edit the Configuration first, to set the account address and password (optionally). Sadly, poezio doesn’t allow account creation yet, so if you don’t have an account you will have to either use another client like gajim to create your account, or stay in anonymous mode.

After obtaining an account and setting the jid config option to the right value, you should go through the configuration file to get an overview of the different configuration options available. If you don’t set the value of the password option, you will be prompted to enter it on startup.

Joining rooms¶

Just as in the anonymous mode, the /join command allows you to join a chatroom and start talking to people right away. It opens a new Chatroom tab.

Talking to people¶

Just as in the anonymous mode, you can use the /message command if you know the address of people you want to talk to. This will open a Conversation tab.

Adding people¶

However, one of the benefits of having an account is to have contacts, see when they are online and offline, see their activity, mood, etc. To this end, you should add the people you know to your contact list.

The Contact list tab is the tab numbered 0, and the only one which is always open. To add people, use /add, to accept a contact request use /accept.

Using end-to-end encryption¶

To use OTR end-to-end encryption, you have to enable the OTR plugin. The plugin requires python-potr for python3, so make sure you have it installed first.

After that, you can enable the OTR plugin with /load otr. Further usage is discussed in the plugin documentation.

Exiting poezio¶

Use the /exit command to quit poezio.