IDC Matrix help
РусскийIDC Matrix is an encrypted messenger for iOS, Android and the browser. Item names can differ slightly between the apps. Did not find an answer? Write to us with "Report bug" (see Feedback).
Getting started#
- Your account address looks like
@login:idc.md. Other people find you by it. - Login: 3 to 65 characters, lowercase Latin letters, digits, dot,
_and-, starting with a letter or a digit. Password: at least 8 characters. - You can be signed in on several devices at once: phone, tablet, browser (web.matrix.idc.md). Each sign-in is a separate session. A new session must be verified, otherwise it cannot read the encrypted messages.
- Right after your first sign-in, save your recovery key: without it, the old messages cannot be opened if you lose all your devices.
Chat list#
- Tabs above the list: "All", "Unreads", "People" and your folders.
- A long press on a chat opens its menu: mark as read, favourite, add to a folder, mute, leave.
- Favourite chats are always at the top of the list and of any folder.
- A long press on "Unreads" offers "Mark all as read".
Folders#
- The "+" tab creates a folder. A folder can include all direct chats, all groups and chosen chats, and exclude the muted, the read, the low priority and chosen chats.
- A chat is added to a folder from its menu too: "Add to folder".
- A long press on a folder tab: edit, mark all as read, reorder, delete. Deleting a folder keeps its chats.
- Folders are the same on all your devices. Up to 10 folders, up to 200 chats in a folder.
Saved messages#
"Saved messages" is a chat with yourself: notes, links, forwarded messages. Only you see it, on all your devices. It opens from the "+" menu and from the chat list, and you can forward and share to it from other apps.
Chat invites#
The setting "Who can add me to chats" decides what happens with invites:
- Only people I know: an invite from someone you know is accepted by itself, and the chat appears in the list at once. People you know are those you already have a direct chat or a private chat in common with, your contacts and the users you verified.
- Nobody: every invite waits for your decision.
- Everyone (iOS only): every invite is accepted.
The invites that are not accepted by themselves are in the chat list. An invite shows who invites you, and lets you accept, decline or report it. The setting is the same for all your devices.
Direct chats#
- A new direct chat: "+" → "Start chat", find the person by name, login, phone or email. If you already have a chat with them, that chat opens.
- If the other person declined the invite, left the chat or was removed, a bar at the top of the chat offers to leave the chat or invite them again.
Messages#
- Reply: swipe the message to the left or choose "Reply" in its menu. You can reply with a photo, a video or a file too.
- Quick reaction: a double tap on a message adds the reaction (👍 by default) or removes it. The reaction is chosen in the timeline settings.
- Forward: "Forward" in the message menu. You can choose several chats at once. A forwarded message shows who it is from.
- Several messages: "Select" in the message menu, check the ones you need, then forward, delete or share them.
- Delete: for 3 seconds after deleting, you can tap "Undo".
- Spoiler: text between
||two bars||is hidden until tapped. - Caption of a photo or a video is entered on the preview screen.
- Edit: "Edit" in the menu of your message. Edits do not mark the chat unread.
- Translate: "Translate" in the message menu. The translation is made on the device, the text is sent nowhere.
Send without sound#
A long press on the send button → "Send without sound". The recipient sees the notification, but the phone does not ring or vibrate. Good for late messages.
Send later#
A long press on the send button → "Send later": in 1 hour, in 3 hours, tomorrow at 9:00 or at a chosen time (at most 7 days ahead). The server sends the message, even if your phone is off. The scheduled messages are in the chat info → "Scheduled messages": you can send them now or cancel them there.
Reminders#
Message menu → "Remind me": in 1 hour, in 3 hours, tomorrow at 9:00 or at a chosen time. A notification comes at that time; tapping it opens the message. The reminder is kept on this device only.
Drafts#
Unsent text is saved and appears on your other devices. In encrypted chats, the draft is encrypted too.
"@" mentions#
If you were mentioned and have not seen the message yet, an "@" button appears in the chat. A tap goes to the earliest unseen mention. A long press marks them all as seen.
Threads#
A thread is a separate discussion of a message in a group, not to clutter the main chat. "Reply in thread" in the message menu. All the threads of a chat are behind the threads button at the top. In groups, thread notifications come only if you take part in the thread or are mentioned.
A chat and its settings#
The chat info opens with a tap on the chat name.
- Edit: the chat photo, name and topic.
- Attachments: the photos and videos, files and links of the chat.
- Pinned: important messages: "Pin" in the message menu. The bar at the top of the chat goes through them in turn.
- Search in the messages of the chat.
- Security & privacy: encryption and who sees the history.
- Roles & permissions (in groups): administrators, moderators and what members may do.
Auto-deleting messages#
Chat info → "Message retention": messages older than the chosen period are deleted for all members (1 hour, 1 day, 1 week, 1 month or another period). The default period for new chats is in Settings → Security.
Wallpapers#
Settings → Timeline → "Chat wallpapers" sets them for all chats. Chat info → "Wallpaper" sets one for this chat. Wallpapers are the same on all your devices.
Contacts#
- Your own name for someone: member details → "Rename". Only you see the name; it replaces their name everywhere: in the list, in the chat, in calls and notifications.
- Phone contacts: if you allow access to the contacts, "Start chat" shows the people you know who already use IDC Matrix. The search uses hashed numbers and addresses.
- Share a contact: the "Contact" button of the composer, or "Share" in the member details.
- Links like
https://to.matrix.idc.md/#/@login:idc.mdopen a person or a chat right in the app.
Calls#
- Voice and video calls: the buttons at the top of a direct chat.
- The call screen shows the step the connection is at.
- Direct connection (Settings → Security → Calls): when off, calls always go through the server, and the other person does not learn your IP address. The call quality can be lower.
- If a call does not connect: check the internet on both sides, try turning the direct connection off, then send a bug report right after the failed call.
Notifications#
- Mute for a while: chat menu → "Mute": for 1 hour, 8 hours, 1 day, 7 days or forever. Mentions and calls still come. The mute ends by itself.
- Notifications for all chats are in Settings → Notifications.
- If notifications do not come: check that the app may send them in the phone settings, that background activity is allowed and that battery saving is off for the app.
- If you already read a message on another of your devices, its notification on the phone may not appear.
Encryption#
Direct chats and private groups are encrypted: only you and the other members can read the messages, the server cannot. The keys that decrypt them are kept on your devices and in an encrypted backup.
Not to lose your messages:
- Verify each new device of yours.
- Save your recovery key.
Do not sign out of your last device before saving the recovery key.
Verifying a session#
A new device (session) must be verified to get the keys of the older messages and to be trusted by the others. Two ways:
- From another device: a request appears there; compare the emoji on both screens and tap "They match".
- With the recovery key or the passphrase, if no other device is at hand.
If the request does not appear, open the app on the other device and wait a little, or choose "Verify" in the session list.
Recovery key#
The recovery key is a long set of letters and digits (or your passphrase) that opens the backup of your encryption keys. It is needed if all your devices are lost or you signed out of all of them.
- Set it up or check it: Settings → Security → Recovery key.
- Keep it in a password manager or write it down. We cannot recover it.
- The key backup is created automatically on a verified device; the recovery key opens it on a new one.
Resetting your identity#
If no verified device is left and the recovery key is lost, the only way is to reset your identity. Your account, contacts, settings and chat list are kept, but the older history of encrypted messages becomes unavailable, and all your devices and contacts must be verified again. Reset only if there is no other way.
Someone's identity changed#
The warning "identity changed" means the other person reset it (for example, after losing their devices), or, more rarely, that someone pretends to be them. Check with them in person or on the phone, then verify them again: member details → "Verify", compare the emoji.
Verifying someone#
Member details → "Verify". Compare the emoji on both screens, best in person or during a call. A verified person is marked with a badge, and you know you are writing to them indeed.
Trusted verifiers#
You can trust the verifications of a chosen person, for example the security officer of your organisation: the users they verified become verified for you too, on all your devices. Such a user's details say "Verified via …".
- Settings → Security → "Trusted verifiers" → "Add". Only someone you verified yourself can be added.
- "Publish my verifications": the people who trust you can use your verifications.
- Choose only people you fully trust: whoever takes over their account can verify anyone for you.
Devices and sessions#
Settings → Sessions: all the devices you are signed in on. You can rename a session, verify it and sign out of other devices there. An unknown session is a reason to sign it out and change your password.
To sign out of the current device, use "Sign out" in the settings. Before signing out of your last device, make sure you saved the recovery key.
Privacy#
- Link previews in encrypted chats are off by default: the server would learn the link to build them.
- Calls can go only through the server, hiding your IP address (see Calls).
- Report a message or a user from the message menu or the member details.
- Ignore a user: member details → "Ignore". Their messages and invites stop coming.
Feedback#
Found a bug or something does not work right: Settings → "Report bug" (on a phone, shaking it is often enough). Describe what you did and what happened, and keep the logs checked: they hold no text of your messages, but what helps to find the cause.