"How to set up Jami" tutorial page?
A "How to set up Jami" tutorial page, with screenshots, would be very useful. I could point friends to it. I can't find one online.
The first screen asks me if I want to register. My first reaction: I don't know; what is registration? What data of mine does it publish publicly? It is also not obvious what the password is used for (and that it's optional). The Jami website FAQ has some basic info, but it would be nice if it linked to the more technical version, like https://git.jami.net/savoirfairelinux/ring-project/wikis/tutorials/Frequently-Asked-Questions#account-1
It would be very nice if the first screen had a link to a setup tutorial.
Writing a setup tutorial is one of the few things which is easier for a novice ignoramus than for someone heavily involved with the project, so here's a draft. The account visible is a dummy testing account which I intend to abandon, and I have blacked out my computer name and mac address. I've tried to make it ridiculously detailed, so that someone with very little pre-existing knowledge can follow it; it might benefit from editing down, default-collapsing some of the details, or even a separate short version linking to an expanded one, as most people won't need this much detail. If you can use it, please ask for any revisions you'd like.
How to get started with Jami
First, install Jami, from your package manager or from https://jami.net/download/.
Open it. You will see this page:
Select "Create new Jami account". You will then see this page:
The profile name is an entirely internal name; it will not be relayed to anyone, it's just what you want to call the account, for your own use. You can actually leave all the other fields on this page blank, but you might want to learn what they do before deciding to do that.
You then need to decide whether you want to register a username (default; coloured background shows in switch) or not (click, so that grey background shows in switch). For technical reasons, Jami names accounts with Infohash names, which are 40-character strings of arbitrary letters and digits. If you think it would be easier to have a username like "SuperChatty", pick one now. Registering it will make a public online record of which Infohash belongs to that name. Once you have registered a name you can't change it; you can only abandon your registered name and start again. If you aren't yet sure if you want to register, don't worry, you can do it later.
Anyone wishing to contact you on Jami will need to know a user ID for you; this is either the 40-character Infohash or a registered name (more details on user IDs).
Not that this example screenshot shows an absurdly unmemorable registered name, "M9979998878788". You probably want a more memorable name, like "SuperChatty".
You may also pick a password. This is optional. Jami is a peer-to-peer system; all the data (except the public database of registered usernames) is stored on your own computer. If you pick a password, it will be used to encrypt your account. This protects your information if someone else has physical control of your computer (say, because they stole it). If you are not worried about this, you can leave the "password" fields blank.
If you do pick a password, then be sure not to forget it. You will not be able to retrieve your account if you do.
If you install Jami on multiple devices (say, your computer and your phone), you can use the same account on all of them, but you'll have to set each password separately. This will be explained later.
When you have filled out all the fields you want to fill out, click "Next".
You have now created your account. If you want someone to contact you, you can give them your user ID in the form of a QT code (button in center of screen). If they have given you a user name ID? have not tested, please confirm, you can now contact them.
Go to the search box with the magnifying glass in the top left corner. Type in the name your friend gave you. Press the "Enter" key. Your friend's information will be added in the column below the search box. To talk to them in text chat, a voice call, or a video call, right-click in the friend and choose from the drop-down menu.
You can now converse.
Bear in mind that there is only one copy of your account information, on your computer. If you lose it, your account is gone. You might want to make a backup, or you might want to use the same Jami account on another device (this means making a copy of your account data on the second device, so it is a type of backup). You might also want to change or check your settings. To do all this, click on the "Settings" button (in the center of the top bar, with a gear icon).
You will get this screen, showing your Infohash ID and your registered name and password (if you have them). You can change your password by clicking on it. Instead of the black box shown in this screenshot, you will see your computer name and mac address. These are the names your computer uses for communications with other computers.
To copy your account data, click "Export account". Save the file (it will end with ".gz"). Save a copy to another device (a USB stick, your phone, another computer). You now have a backup.
If you want to use the same account on another device, install Jami on that other device, too. Then click on the long button in the top bar that contains your profile name ("Morgan", in these screenshots). Choose "Add account..." from the drop-down menu. You will get this screen:
Click on "Link this device to an account". You will get this screen:
Click on the button under "Or import from file:". Select the ".gz" file you exported earlier. Click "Next".
I haven't actually done this, so I'll stop here.