From d00513ed277f83d37ff6fd2f293e0a7dd47b568b Mon Sep 17 00:00:00 2001 From: "Evgeny @ SimpleX Chat" <259188159+evgeny-simplex@users.noreply.github.com> Date: Wed, 4 Nov 2026 09:07:06 +0000 Subject: [PATCH] docs: user guide matches the 7.1 apps (#7997) * docs: user guide for the 7.1 apps * docs, website: guide order, badge benefits, message expiry; soft line breaks on the site * docs: guide videos for the first profile, invitations, joining and the address * docs: guide screens with the iPhone status bar * docs: guide shows full and cut screens only * docs: guide pages corrected in place, keeping master's structure * docs: group chat and SimpleX address pictures in the iPhone frame * docs: plainer wording in the guide * docs: guide checked against how SimpleX explains its features * docs: guide answers on profiles, channel privacy, SOCKS and names * docs: android guide picture from the emulator in the pixel 7 frame --- ...5.8-private-message-routing-chat-themes.md | 2 +- ...-v6-private-routing-new-user-experience.md | 2 +- ...eak-law-lead-to-mass-scale-surveillance.md | 4 +- docs/FAQ.md | 10 +- docs/contributing/CODE.md | 1 + docs/guide/README.md | 82 ++- docs/guide/app-settings.md | 196 ++++-- docs/guide/audio-video-calls.md | 55 +- docs/guide/channel-webpage.md | 38 +- docs/guide/channels.md | 245 +++++++ docs/guide/chat-profiles.md | 92 ++- ...app-settings-advanced-network-settings.png | Bin 0 -> 144656 bytes docs/guide/images/app-settings-settings.png | Bin 0 -> 112899 bytes .../images/audio-video-calls-settings.png | Bin 0 -> 123164 bytes docs/guide/images/channels-create.png | Bin 0 -> 96292 bytes .../images/chat-profiles-create-profile.png | Bin 0 -> 87275 bytes .../images/chat-profiles-hide-profile.png | Bin 0 -> 106696 bytes docs/guide/images/groups-chat.png | Bin 0 -> 261767 bytes docs/guide/images/groups-create.png | Bin 0 -> 92069 bytes docs/guide/images/groups-info.png | Bin 0 -> 109491 bytes docs/guide/images/groups-member-info.png | Bin 0 -> 92294 bytes docs/guide/images/groups-preferences.png | Bin 0 -> 140329 bytes docs/guide/images/groups-profile.png | Bin 0 -> 89078 bytes .../linked-devices-connect-to-desktop.png | Bin 0 -> 80202 bytes .../images/making-connections-address.png | Bin 0 -> 139162 bytes .../making-connections-contact-info.png | Bin 0 -> 109764 bytes .../making-connections-video-address.jpg | Bin 0 -> 45812 bytes .../making-connections-video-invite.jpg | Bin 0 -> 38816 bytes .../images/making-connections-video-join.jpg | Bin 0 -> 41444 bytes docs/guide/images/managing-data-chat-data.png | Bin 0 -> 94587 bytes .../images/managing-data-migrate-here.png | Bin 0 -> 87236 bytes .../guide/images/managing-data-passphrase.png | Bin 0 -> 110934 bytes .../images/notifications-android-modes.png | Bin 0 -> 159868 bytes docs/guide/images/notifications-ios-modes.png | Bin 0 -> 102778 bytes .../images/privacy-security-verify-code.png | Bin 0 -> 117616 bytes docs/guide/images/readme-get-started.png | Bin 0 -> 124960 bytes .../guide/images/readme-video-get-started.jpg | Bin 0 -> 47863 bytes docs/guide/images/send-messages-chat.png | Bin 0 -> 331605 bytes .../send-messages-contact-preferences.png | Bin 0 -> 152468 bytes .../images/supporter-badges-redeem-code.png | Bin 0 -> 88482 bytes .../supporter-badges-support-simplex.png | Bin 0 -> 122930 bytes docs/guide/linked-devices.md | 152 +++++ docs/guide/making-connections.md | 68 +- docs/guide/managing-data.md | 76 ++- docs/guide/notifications.md | 154 +++++ docs/guide/privacy-security.md | 72 ++- docs/guide/register-simplex-name.md | 39 +- docs/guide/secret-groups.md | 66 +- docs/guide/send-messages.md | 93 ++- docs/guide/supporter-badges.md | 182 ++++++ scripts/docs/frame-guide-images.py | 599 ++++++++++++++++++ website/.eleventy.js | 2 +- website/langs/ar.json | 3 - website/langs/az.json | 3 - website/langs/bg.json | 3 - website/langs/cs.json | 3 - website/langs/de.json | 3 - website/langs/en.json | 12 +- website/langs/es.json | 3 - website/langs/fa.json | 3 - website/langs/fi.json | 3 - website/langs/fr.json | 3 - website/langs/he.json | 3 - website/langs/hu.json | 3 - website/langs/id.json | 3 - website/langs/it.json | 3 - website/langs/ja.json | 3 - website/langs/nl.json | 3 - website/langs/pl.json | 3 - website/langs/pt_BR.json | 3 - website/langs/ro.json | 3 - website/langs/ru.json | 3 - website/langs/tr.json | 3 - website/langs/uk.json | 3 - website/langs/zh_Hans.json | 3 - website/langs/zh_Hant.json | 3 - website/src/_data/docs_sidebar.json | 7 +- website/src/_data/guide_dropdown.json | 28 +- 78 files changed, 2036 insertions(+), 310 deletions(-) create mode 100644 docs/guide/channels.md create mode 100644 docs/guide/images/app-settings-advanced-network-settings.png create mode 100644 docs/guide/images/app-settings-settings.png create mode 100644 docs/guide/images/audio-video-calls-settings.png create mode 100644 docs/guide/images/channels-create.png create mode 100644 docs/guide/images/chat-profiles-create-profile.png create mode 100644 docs/guide/images/chat-profiles-hide-profile.png create mode 100644 docs/guide/images/groups-chat.png create mode 100644 docs/guide/images/groups-create.png create mode 100644 docs/guide/images/groups-info.png create mode 100644 docs/guide/images/groups-member-info.png create mode 100644 docs/guide/images/groups-preferences.png create mode 100644 docs/guide/images/groups-profile.png create mode 100644 docs/guide/images/linked-devices-connect-to-desktop.png create mode 100644 docs/guide/images/making-connections-address.png create mode 100644 docs/guide/images/making-connections-contact-info.png create mode 100644 docs/guide/images/making-connections-video-address.jpg create mode 100644 docs/guide/images/making-connections-video-invite.jpg create mode 100644 docs/guide/images/making-connections-video-join.jpg create mode 100644 docs/guide/images/managing-data-chat-data.png create mode 100644 docs/guide/images/managing-data-migrate-here.png create mode 100644 docs/guide/images/managing-data-passphrase.png create mode 100644 docs/guide/images/notifications-android-modes.png create mode 100644 docs/guide/images/notifications-ios-modes.png create mode 100644 docs/guide/images/privacy-security-verify-code.png create mode 100644 docs/guide/images/readme-get-started.png create mode 100644 docs/guide/images/readme-video-get-started.jpg create mode 100644 docs/guide/images/send-messages-chat.png create mode 100644 docs/guide/images/send-messages-contact-preferences.png create mode 100644 docs/guide/images/supporter-badges-redeem-code.png create mode 100644 docs/guide/images/supporter-badges-support-simplex.png create mode 100644 docs/guide/linked-devices.md create mode 100644 docs/guide/notifications.md create mode 100644 docs/guide/supporter-badges.md create mode 100644 scripts/docs/frame-guide-images.py diff --git a/blog/20240604-simplex-chat-v5.8-private-message-routing-chat-themes.md b/blog/20240604-simplex-chat-v5.8-private-message-routing-chat-themes.md index 9bd342a146..207d1b842b 100644 --- a/blog/20240604-simplex-chat-v5.8-private-message-routing-chat-themes.md +++ b/blog/20240604-simplex-chat-v5.8-private-message-routing-chat-themes.md @@ -95,7 +95,7 @@ The diagram below shows all the encryption layers used in private message routin For private routing to work, both the forwardig and the destination relays should support the updated messaging protocol - it is supported from v5.8 of the messaging relays. It is already released to all relays preset in the app, and available as a self-hosted server. We updated [the guide](../docs/SERVER.md) about how to host your own messaging relays. -Because many self-hosted relays did not upgrade yet, private routing is not enabled by default. To enable it, you can open *Network & servers* settings in the app and change the settings in *Private message routing* section. We recommend setting *Private routing* option to *Unprotected* (to use it only with unknown relays and when not connecting via Tor) and *Allow downgrade* to *Yes* (so messages can still be delivered to the messaging relays that didn't upgrade yet) or to *When IP hidden* (in which case the messages will fail to deliver to unknown relays that didn't upgrade yet unless you connect to them via Tor). +Because many self-hosted relays did not upgrade yet, private routing is not enabled by default. To enable it, you can open *Network & servers* settings in the app and change the settings in *Private message routing* section. We recommend setting *Private routing* option to *Unprotected* (to use it only with unknown relays and when not connecting via Tor) and *Allow downgrade* to *Yes* (so messages can still be delivered to the messaging relays that didn't upgrade yet) or to *When IP hidden* (in which case the messages will fail to deliver to unknown relays that didn't upgrade yet unless you connect to them via Tor).\ See [F.A.Q. section](../docs/FAQ.md#does-simplex-protect-my-ip-address) for answers about private message routing. Read more about the technical design of the private message routing in [this document](https://github.com/simplex-chat/simplexmq/blob/stable/rfcs/done/2023-09-12-second-relays.md) and in [the messaging protocol specification](https://github.com/simplex-chat/simplexmq/blob/stable/protocol/simplex-messaging.md#proxying-sender-commands). diff --git a/blog/20240814-simplex-chat-vision-funding-v6-private-routing-new-user-experience.md b/blog/20240814-simplex-chat-vision-funding-v6-private-routing-new-user-experience.md index de9e33a87e..d6aba6ef62 100644 --- a/blog/20240814-simplex-chat-vision-funding-v6-private-routing-new-user-experience.md +++ b/blog/20240814-simplex-chat-vision-funding-v6-private-routing-new-user-experience.md @@ -60,7 +60,7 @@ We are very happy to announce that we now have funds to move faster – we raise When Jack discovered SimpleX Chat last year, he [posted on Twitter](https://x.com/jack/status/1661681076983529479): -> Better than Signal? Looks promising. +> Better than Signal? Looks promising.\ > A few bugs and UX issues but great foundation. Love that it’s public domain. And [on Nostr](https://primal.net/e/note1txz9xmmc456kwcg7zrsrtqrhn7as29ptuz0qulu452k8n85hsshqq6uh6q): diff --git a/blog/20241218-oppose-digital-ids-they-break-law-lead-to-mass-scale-surveillance.md b/blog/20241218-oppose-digital-ids-they-break-law-lead-to-mass-scale-surveillance.md index 8a8fffffb4..add075e40a 100644 --- a/blog/20241218-oppose-digital-ids-they-break-law-lead-to-mass-scale-surveillance.md +++ b/blog/20241218-oppose-digital-ids-they-break-law-lead-to-mass-scale-surveillance.md @@ -34,14 +34,14 @@ To make your voice heard, email your MP expressing your rejection of digital IDs *I object to the introduction of digital IDs in pubs or any other public places for these reasons:* -1. *It violates the European Convention of Human Rights, article 8: “Everyone has the right to respect for his private and family life” (https://fra.europa.eu/en/law-reference/european-convention-human-rights-article-8-0).* +1. *It violates the European Convention of Human Rights, article 8: “Everyone has the right to respect for his private and family life” (https://fra.europa.eu/en/law-reference/european-convention-human-rights-article-8-0).*\ *Asking to present digital IDs when proof of identity is not legally required, even if it is optional, disrespects our privacy, and is therefore illegal.* 2. *It will not be an effective measure in reducing the violations of the law. People who want to circumvent it, will find a way.* 3. *It will increase crime, because combining a large amount of private information in a single system increases the risks of this information becoming available to criminals, who will exploit it for financial crimes and identity theft.* *I kindly ask you to oppose this plan, both publicly and during any discussions in the UK Parliament.* -*Sincerely yours,* +*Sincerely yours,*\ *…* 2. [**Find the email address of your MP**](https://members.parliament.uk/members/Commons) and copy it to the email. diff --git a/docs/FAQ.md b/docs/FAQ.md index 21cb08417f..eb86d13c2e 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -82,7 +82,7 @@ When "Incognito Mode” is turned on, your currently chosen profile name and ima It is quite a complex process, but fortunately all of this happens in the background, so it's simple to use. -Whenever somebody connects to you via your address, they basically ask your client whether they want to establish connection. After that, you can either agree or disagree. +Whenever somebody connects to you via your address, they basically ask your client whether they want to establish connection. After that, you can either agree or disagree.\ If interested, please read more: [Addresses and invitations](./guide/making-connections.md). ### How to configure and delete groups? @@ -97,7 +97,7 @@ Yes! Currently, there are six emojis available. What's more, you can respond to It's quite simple: - one checkmark - message is delivered to the relay (the server). -- two checkmarks - message is delivered to the recipient's device. +- two checkmarks - message is delivered to the recipient's device.\ "sent" means accepted by the relay for delivery, "delivered" - stored on the recipient device. Also see: [I do not see the second tick on the messages I sent](#i-do-not-see-the-second-tick-on-the-messages-i-sent) @@ -178,12 +178,12 @@ becomes: `simplex:/i#E74vSxMwDnEx6DAvRCZmzBeZwwAseJUD/yVTHjaaH_EzL19DG7fvd46Mjry ### How to change servers to my own? -Add your server in Settings -> Network & servers -> Your servers. If you have multiple profiles, you need to add your server in every profile. +Add your server in Settings -> Network & servers -> Your servers. If you have multiple profiles, you need to add your server in every profile.\ After that, disable all preset servers. If you have multiple profiles, you must first add your server to all profiles for this option to be available. To resolve SimpleX public names, if your server does not support it, you may leave preset servers enabled only for resolving the public names. -Please note: configured servers only determine which servers will be used for the new connections (members/contacts). Previously created connections don't switch automatically. You can manually switch all existing contacts and small/important groups (each member needs to be switched), and then leave and re-join all large groups. +Please note: configured servers only determine which servers will be used for the new connections (members/contacts). Previously created connections don't switch automatically. You can manually switch all existing contacts and small/important groups (each member needs to be switched), and then leave and re-join all large groups.\ You can switch contacts/members manually to another server by going to their profile and clicking on "Change receiving address", note that the current server must be online for the address change to work. ## Troubleshooting @@ -420,7 +420,7 @@ SimpleX Chat Ltd is funded by private investors and venture capital. As an open- Here are some reflections on VC funding being a necessity for a project at this scale, as well as sustainability and profitability for longtime operations: https://www.poberezkin.com/posts/2023-10-31-why-privacy-impossible-without-venture-funding.html -And another perspective from a team member on the delicate balance of venture-backed and nonprofit structures, and the plans for the SimpleX network protocols to evolve under the stewardship of nonprofit entities in various jurisdictions, so that its continued evolution aligns more closely with the vision of community-driven, independent and transparent governance: +And another perspective from a team member on the delicate balance of venture-backed and nonprofit structures, and the plans for the SimpleX network protocols to evolve under the stewardship of nonprofit entities in various jurisdictions, so that its continued evolution aligns more closely with the vision of community-driven, independent and transparent governance:\ [https://simplex.chat/blog/20240404-why-i-joined-simplex-chat-esraa-al-shafei.html](../blog/20240404-why-i-joined-simplex-chat-esraa-al-shafei.md). ### What will be the business model? diff --git a/docs/contributing/CODE.md b/docs/contributing/CODE.md index fcdbeb4081..7c67fb4a4f 100644 --- a/docs/contributing/CODE.md +++ b/docs/contributing/CODE.md @@ -64,6 +64,7 @@ Some files that use CPP language extension cannot be formatted as a whole, so in - **Never move existing code or sections around** - add new content at appropriate locations without reorganizing existing structure. - When adding new sections to documents, continue the existing numbering scheme. - Minimize diff size - prefer small, targeted changes over reorganization. +- When you change what users see or do in the apps, update the user guide (docs/guide) in the same pull request. **Code analysis and review:** - Trace data flows end-to-end: from origin, through storage/parameters, to consumption. Flag values that are discarded and reconstructed from partial data (e.g. extracted from a URI missing original fields) — this is usually a bug. diff --git a/docs/guide/README.md b/docs/guide/README.md index fe1546af0a..cb39d81102 100644 --- a/docs/guide/README.md +++ b/docs/guide/README.md @@ -3,20 +3,25 @@ title: Quick start --- # SimpleX Chat User Guide -The first messaging platform that has no user identifiers of any kind — 100% private by design. +The first messaging network that has no user identifiers of any kind. ## Contents - [Quick start](#quick-start) - scroll down this page +- [Making connections](./making-connections.md) - [Sending messages](./send-messages.md) -- [Secret groups](./secret-groups.md) +- [Groups](./secret-groups.md) +- [Channels](./channels.md) - [Channel webpage](./channel-webpage.md) - [Chat profiles](./chat-profiles.md) - [Registering a SimpleX name](./register-simplex-name.md) - [Managing data](./managing-data.md) +- [Linked devices](./linked-devices.md) - [Audio & video calls](./audio-video-calls.md) +- [Notifications](./notifications.md) - [Privacy & security](./privacy-security.md) - [App settings](./app-settings.md) +- [Supporter badges](./supporter-badges.md) ## Quick start @@ -24,61 +29,98 @@ The first messaging platform that has no user identifiers of any kind — 100% p After downloading SimpleX Chat via the links at https://simplex.chat: -- Open the app. -- Create a new profile by inputting your display name and full name (optional). -- Tap on "Create". +- Open the app and tap "Get started". On desktop, click "Create your profile". +- Create a new profile by inputting your profile name. +- Tap on "Create profile". -This profile is local to the device, it is not stored anywhere else +This profile is stored on your device and shared only with your contacts. +SimpleX servers cannot see it. + +On desktop, the app then asks you to set a database passphrase or to use a +random one, see [Database passphrase](./managing-data.md#database-passphrase). +You can also click "Link a mobile" instead of "Create your profile" to use the +chat profiles of your phone from the computer, see [Linked +devices](./linked-devices.md). ### Choose notifications mode -After you have created the chat profile the app will ask you to choose notifications mode. +After you have created the chat profile, the app shows "Your network". On iOS +and Android, tap "Setup notifications" there to choose notifications mode. - +iOS Push notifications screen with the modes Instant, Periodic and No push server Please read their description, as on iOS it is trade-off between convenience and privacy, with instant notifications sharing more meta-data with the servers, and on Android it is a trade-off between notification delays and battery life. You can read more about [the differences between notifications work on Android and iOS](../../blog/20220404-simplex-chat-instant-notifications.md). +You can also tap "Setup routers" to choose server operators. Then tap +"Continue", and "Accept" on the "Network commitments" screen to start using the +app. + +To change notifications mode later, see [Notifications](./notifications.md). + ### Connect to developers -When you just start using the app, you can tap "chat with the developers" to ask any questions or just to test the app - feel free to send any test messages. +When you just start using the app, you can connect to "Ask SimpleX Team" to ask +any questions or just to test the app - feel free to send any test messages. -This button will disappear once you make the first connection. To connect to the developers later: +Each new chat profile has this contact. To connect, tap the pencil button, tap +"Ask SimpleX Team" in the list of your contacts and choose "Use current profile" +or "Use new incognito profile". You can also connect to the developers via the +app settings: - [Open the app settings](./app-settings.md#opening-the-app-settings). -- Tap on "Send questions and ideas". +- Tap on "Help & support", then "Send questions and ideas". ### Join some user groups There are links to join several [user groups](../../README.md#join-user-groups) on our GitHub page - join them to ask any questions and discuss ideas. -You can also find some other user-managed groups via online search. +You can also find groups and channels in [SimpleX +Directory](https://simplex.chat/directory/), and some other user-managed groups +via online search. To join a group via a link: - Get a link to a SimpleX user group, which you can get from your existing SimpleX conversations or by finding it online. - Tap on a button in the lower right-hand of the screen. -- Tap on "Connect via link / QR code" button. +- Tap on "Scan / Paste link" (iOS), "Paste link / Scan" (Android) or "Paste + link" (desktop), and paste the link, or scan its QR code on iOS and Android. +- Tap on "Open group", then "Join group". ### Connect to friends - Tell your friends to download SimpleX Chat app via one of the links here: https://simplex.chat -- Create a one-time link for each of you friends by tapping new chat button (Android: a floating pencil button in the bottom right corner, iOS: a pencil button in the top right corner) -- Tap _Create one-time invitation link_. +- Create a one-time link for each of your friends by tapping the pencil button + (in the bottom right corner, or in the top right corner on iOS when the + toolbar is at the top). +- Tap "Create 1-time link". - Share each link with a different friend, or alternatively let them scan a QR code. -- You can optionally assign a different alias to each link, to know when they connect who is who, if they use incognito mode, for example. -- To use your link or QR code, tell your friends to tap new chat button and then tap on "Connect via link / QR code". -- They can either scan QR code or paste the link. If they opened the link in the browser, they need to tap "Open in mobile app" button on the page. +- You can optionally set a different contact name for each link, to know when + they connect who is who, if they use incognito mode, for example: swipe the + pending connection in the chat list and tap "Name" (iOS), or long-press it + (Android) or right-click it (desktop) and choose "Set contact name". +- To use your link or QR code, tell your friends to tap the pencil button and + then tap on "Scan / Paste link" (iOS), "Paste link / Scan" (Android) or "Paste + link" (desktop). +- They can either scan QR code (iOS and Android) or paste the link, then tap + "Open new chat" and "Connect", see [Connect via a link or a + name](./making-connections.md#connect-via-a-link-or-a-name). If they opened + the link in the browser, they need to tap "Open SimpleX app" button on the + page. -Watch the video on [the website](https://simplex.chat) that shows how it works. +Watch the [video](https://youtu.be/2iIibhaoMhI) that shows how it works. You can also create a [long-term contact address](./app-settings.md#your-simplex-contact-address). ### Explore the app +Tap your profile image in the chat list toolbar to open the menu with your chat +profiles, your SimpleX address, chat preferences and the app settings. + Most app settings are shared for all profiles, but some settings are specific to chat profile. Read more in [App settings](./app-settings.md) page. -Many conversation actions are available via long-press or swipe – try them! +Many conversation actions are available via long-press or swipe (right-click on +desktop) – try them! diff --git a/docs/guide/app-settings.md b/docs/guide/app-settings.md index 3a966e18e1..99e2caf7b6 100644 --- a/docs/guide/app-settings.md +++ b/docs/guide/app-settings.md @@ -8,18 +8,23 @@ title: App settings To open app settings: - Open the app. -- Tap on your user profile image in the upper left-hand of the screen. -- If you have more than one profile, tap the current profile again or choose Settings. +- Tap on your user profile image in the lower left-hand of the screen (in the + upper left-hand, if the reachable toolbar is off in [Appearance](#appearance)). +- Tap **Settings**. ## Your profile settings -This section is labelled **"You"** in the app settings. +These settings are in the menu that opens when you tap your user profile image. +The menu also has **Use from desktop** (iOS and Android) or **Link a mobile** +(desktop), see [Linked devices](./linked-devices.md). ### Your active profile Tap on your avatar/name to update your current profile names and avatar. -Display name cannot have any spaces and it is recommended to use latin characters and numbers to make it easier to type these names to the users who use [SimpleX Chat for the terminal](../CLI.md) (CLI). +Display name can have spaces, but it is recommended to use latin characters and +numbers to make it easier to type these names to the users who use [SimpleX Chat +for the terminal](../CLI.md) (CLI). **Please note**: When you save your profile, the update will be sent to all your contacts (excluding the contacts with whom your incognito profiles were shared). If you have a large number of contacts it can take several seconds. @@ -31,13 +36,17 @@ This page allows adding and configuring your chat profiles. Please see [Your cha This feature is unique to SimpleX Chat – it is independent from chat profiles. -When "Incognito” is turned on, your current profile name and image are NOT shared with your new contacts. It allows connections with other people without any shared data – when you make new connections or join groups via a link a new random profile name will be generated for each contact or group. +When you choose "Incognito" for a new connection, your current profile name and +image are not shared with this contact or group. It allows connections with +other people without any shared data – when you make new connections or join +groups via a link a new random profile name will be generated for each contact +or group. -Please read more in [this post](../../blog/20220901-simplex-chat-v3.2-incognito-mode.md#incognito-mode). +Please read more in [Incognito mode](./chat-profiles.md#incognito-mode). ### Your SimpleX contact address -    +SimpleX address This page allows you to create a long term address that can be used by other people to connect with you. Unlike 1-time invitation links, these addresses can be used many times, that makes them good to share online, e.g. on other social media platforms. @@ -47,8 +56,6 @@ If you start receiving too many requests via this address it is always safe to r See the comparison with [1-time invitation links](./making-connections.md#comparison-of-1-time-invitation-links-and-simplex-contact-addresses). -Read more in [this post](../../blog/20221108-simplex-chat-v4.2-security-audit-new-website.md#auto-accept-contact-requests). - ### Chat preferences This page allows to configure the chat preferences that would apply to all contacts - they can be changed separately for each contact: @@ -56,52 +63,78 @@ This page allows to configure the chat preferences that would apply to all conta - _disappearing messages_ - to allow disappearing messages in the conversations with you, only if your contacts allow them. - _delete for everyone_ - to allow irreversible message deletion (by default messages are marked as deleted, not fully deleted). "Yes" setting would allow it only if they allow it for you, and "Always" - even if they don't allow. - _voice messages_ - to allow sending voice messages. +- _message reactions_ - to allow message reactions. +- _audio/video calls_ - to allow calls. -To set chat preferences in each contact, tap contact name on top of the conversation and then choose "Contact preferences". +To set chat preferences in each contact, tap contact name in the chat toolbar +and then choose "Contact preferences". -Group owners can set similar preferences for their groups, when the group is created or later: tap group name on top of the conversation and then choose "Group preferences". +Group owners can set similar preferences for their groups, when the group is +created or later: tap group name in the chat toolbar and then choose "Group +preferences". ## Your app settings -This section is labelled **"Settings"** in the app settings. +Tap **Settings** in the menu to open these settings, see [Opening the app +settings](#opening-the-app-settings). + +Your settings on iOS + +**Migrate to another device** is described in [Managing +data](./managing-data.md#migrate-to-another-device), and **Audio & video calls** +in [Audio & video calls](./audio-video-calls.md). ### Notifications -This page allows to configure the notifications mode: instant, periodic or only when the app is running. There are some differences in how these options work on iOS and Android. Please read more in [this post](../../blog/20220404-simplex-chat-instant-notifications.md) about how notifications work. +This page (iOS and Android) allows to configure the notifications mode: instant, +periodic or only when the app is running. On iOS, the third mode is **No push +server**: the app checks messages in the background when iOS allows it. There +are some differences in how these options work on iOS and Android, see +[Notifications](./notifications.md). Please read more in [this +post](../../blog/20220404-simplex-chat-instant-notifications.md) about how +notifications work. -You can also configure whether the message preview is shown when the message arrives. +You can also configure whether the message preview is shown when the message +arrives. To do it, tap **Your privacy**, then **More privacy** and **Show +preview**. -**Please note**: For instant and periodic notifications to work on Android, you need to disable power optimization when prompted by the app, or later via the settings. Also, some variants of Android system require additional settings, for example MIU system on Xiaomi phones requires to enable "Auto start" for the app for the notification service to work. Please read [Don't kill my app](https://dontkillmyapp.com/) guide for any settings that may be required on your device. +**Please note**: For instant and periodic notifications to work on Android, you need to disable power optimization when prompted by the app, or later via the settings. Also, some variants of Android system require additional settings, for example MIU system on Xiaomi phones requires to enable "Autostart" for the app for the notification service to work. Please read [Don't kill my app](https://dontkillmyapp.com/) guide for any settings that may be required on your device. -Also, currently instant notifications have the highest battery consumption - we are working to reduce it to be less or the same as for periodic notifications. +Also, on Android instant notifications have the highest battery consumption. ### Network & servers -This page allows to configure your own SMP relays and change other network settings. - - +This page allows to configure server operators and your own servers, and to +change other network settings. #### SMP servers -       - -By default, the app has preset relays configured – you can change them to your own. +By default, the app uses the servers of two preset operators, SimpleX Chat and +Flux. You can disable them and add your own servers in **Your servers**. When +more than one operator is enabled, the app uses different operators in each +conversation to protect your privacy. This page also allows testing the connection with the servers. -Read more in [this post](../../blog/20221206-simplex-chat-v4.3-voice-messages.md#smp-servers-configuration-and-password). +Read how to host your own servers in [this guide](../SERVER.md). -#### Use SOCKS proxy (Android only) +#### Use SOCKS proxy This option makes the app connect via a SOCKS proxy that should be provided by some other app running on your device. The most typical use for this is to run Orbot app that provides a SOCKS proxy to connect via Tor network, but it can be some other app and it can proxy connections via some other overlay network. +The option is available on all platforms. On Android and desktop, it is in +**Network & servers**, and the default port is 9050. On iOS, it is in **Advanced +network settings**, where you enter the IP address and the port of the proxy. + #### Use .onion hosts ##### Android -**Use .onion hosts** option is only available when **Use SOCKS proxy** is enabled. You can choose: +On Android and desktop, **Use .onion hosts** option is in **SOCKS proxy +settings**, and it is only available when **Use SOCKS proxy** is enabled. You +can choose: - _no_: never use .onion hosts. Choose this option if your SOCKS proxy does not connect via Tor network. - _when available_ (default): when SOCKS proxy is enabled the app assumes that it provides connections via Tor network and use .onion host addresses when SMP relays include them in their configuration. @@ -109,107 +142,154 @@ The most typical use for this is to run Orbot app that provides a SOCKS proxy to ##### iOS -   - -While iOS does not support SOCKS proxies, you can install Orbot app that works as VPN provider. You can choose: +On iOS, this option is in **Advanced network settings**. You can install Orbot +app that works as VPN provider. You can choose: - _no_ (default): do not use .onion hosts. Choose this option if you do not use Orbot or if you use VPN that proxies connections via some other overlay network. - _when available_: use .onion host addresses when SMP relays include them in their configuration. Orbot VPN must be enabled for this option to work. - _required_: always use .onion hosts. Choose this option if you use Orbot VPN and you want to avoid connections without Tor. In this case, if the SMP relay address does not include .onion host, the connection will fail. If you use this option, you can enable "Disable Orbot for non-onion traffic" option in Orbot settings making the rest of your device traffic to not use Tor. -**Please note** VPN on iOS can send some traffic to the usual network, if, for example, VPN app crashes. You can configure enable always-on VPN mode on managed iOS devices, but this is not applicable to most individual devices. +**Please note** VPN on iOS can send some traffic to the usual network, if, for +example, VPN app crashes. You can enable always-on VPN mode on managed iOS +devices, but this is not applicable to most individual devices. #### Transport isolation (BETA) -This option is only available if you have enabled developer tools. +This option sets how the app isolates your traffic. With **Chat profile**, **App +session** (default) and **Server**, the app uses a separate TCP connection for +each chat profile. On Android and desktop, **App session** also uses new SOCKS +credentials every time you start the app, and **Server** uses them for each +server. With **Connection**, the app uses a separate TCP connection for each +contact and group member. -Please read the details in [this post](../../blog/20230204-simplex-chat-v4-5-user-chat-profiles.md#transport-isolation). +The option is in **Advanced network settings**. On iOS, it is available after +you enable [developer options](#show-developer-options). On Android and desktop, +the **Connection** mode is available with developer options. #### Advanced network settings - +Advanced network settings on iOS -If your network is slow, and connections to the servers keep failing (you would see a spinner on your contacts), please increase TCP and protocol timeouts in this page. +If your network is slow, and connections to the servers keep failing (the server +status icon in the chat list toolbar shows it), please increase TCP and protocol +timeouts in this page. + +This page also has the settings of private message routing: "To protect your IP +address, private routing uses your SMP servers to deliver messages." By default, +**Private routing** is set to always. ### Privacy and security +This page is labelled **Your privacy** in the app settings. + #### SimpleX Lock -SimpleX Lock when enabled requires to pass the device authentication when you open the app or use some security- or privacy-sensitive features. +SimpleX Lock when enabled requires to pass the device authentication or to enter +the app passcode when you open the app or use some security- or +privacy-sensitive features. You choose it in **Lock mode** (iOS and Android); +the desktop app uses the app passcode. -You will be offered to enable it after you open the app a few times. +You will be offered to enable it once, when you have more than 2 chats (iOS) or +more than 3 chats (Android and desktop). To enable it later: - [Open the app settings](#opening-the-app-settings). -- Tap on "Privacy & security". -- Toggle on "SimpleX Lock" slider. -- Confirm your phone credentials. +- Tap on "Your privacy". +- Tap on "SimpleX Lock" and toggle on "Enable lock". +- Confirm your phone credentials, or set the app passcode. -Done! Now you will be required to authenticate when you start or resume the app after 30 seconds in background. +Done! Now you will be required to authenticate when you start or resume the app +after 30 seconds in background. You can change this time in **Lock after**. #### Protect app screen - - -This option hides the app screen in recent apps - it is enabled by default. On Android it also prevents screenshots. +This option hides the app screen in recent apps on iOS and Android - it is +enabled by default on Android. On Android it also prevents screenshots. #### Auto Accept Images -Auto-accepting images may reduce privacy – your contacts will know you are online. +With this option, the app receives images, small videos and voice messages +without asking – it is enabled by default. - [Open the app settings](#opening-the-app-settings). -- Tap on "Privacy & security". -- Toggle on "Auto-accept images". +- Tap on "Your privacy". +- Toggle "Auto-accept images". #### Send Link Previews -Enabling sending link previews may reduce privacy – your app will be loading link preview from the website. +Enabling sending link previews may reduce privacy – your app will be loading +link preview from the website. The first time you type a link, the app asks +**Enable link previews?** - [Open the app settings](#opening-the-app-settings). -- Tap on "Privacy & security". +- Tap on "Your privacy". - Toggle on "Send link previews". #### SimpleX Links +This option is in [Developer tools](#developer-tools), in the section +**Deprecated options**. + This option affects how the links to connect to other SimpleX users or to join groups are shown in the conversations. You can choose between: - _description_ (default): only the link description and server host name are shown. The link won't be opened in the browser. - _full link_: the full link is shown. The link will still not be opened in the browser. -- _via browser_: the full link is shown, and it will be opened in the browser. In this case, if the link domain is different from simplex.chat, the link will be shown in red color, as it might be malicious. - -Read more about [SimpleX Links security](../../blog/20221206-simplex-chat-v4.3-voice-messages.md#privacy-and-security-of-simplex-invitation-links). ### Appearance This page allows configuring: - interface language -- app icon +- app icon (iOS and Android) - accent color +- light or dark mode, dark mode colors, wallpaper and other theme colors +- reachable toolbars at the bottom of the screen +- chat layout, message shape and profile image shape +- font size (Android and desktop) and zoom (desktop) +- **Close to tray** (desktop): the app keeps running in the system tray to + receive messages after you close its window. ### Database passphrase & export -This page allows to change the database passphrase, export and import the database and configure the message retention period. +This page is labelled **Chat data** in the app settings. It allows to change the +database passphrase, export and import the database and configure the message +retention period. -Read more in [Managing Your Data](./managing-data.md) page. +Read more in [Managing data](./managing-data.md) page. ## Help & feedback +In the app settings, it is labelled **Help & support**. + This section has information on how to use the app and the links to connect to the team. Please use [Send questions and ideas](https://simplex.chat/contact#/?v=1&smp=smp%3A%2F%2FPQUV2eL0t7OStZOoAsPEV2QYWt4-xilbakvGUGOItUo%3D%40smp6.simplex.im%2FK1rslx-m5bpXVIdMZg9NLUZ_8JBm8xTt%23%2F%3Fv%3D1%26dh%3DMCowBQYDK2VuAyEALDeVe-sG8mRY22LsXlPgiwTNs9dbiLrNuA7f3ZMAJ2w%253D%26srv%3Dbylepyau3ty4czmn77q4fglvperknl4bi2eb2fdy2bh4jxtf32kf73yd.onion) to connect to us via the chat to ask any questions, make any suggestions and report any issues. ## Support SimpleX Chat +Tap **Support SimpleX** in the app settings to get a supporter badge, see +[Supporter badges](./supporter-badges.md). + +These links are in **Help & support**, in the section **Support the project**: + - contribute - the link to the information about how to contribute and to donate to the project. - rate the app - rate and review it on the App Store or Play Store - your feedback helps a lot. - star on GitHub - that also helps us grow very much. +The app settings also have **Crowdfunding on Wefunder**, in the section **Own a +part of SimpleX Chat**: it opens **Invest in SimpleX Chat**, with a link to the +SimpleX Chat crowdfunding on Wefunder. It is shown in the iOS app and in the +Android app from Google Play when the store country is the United States or is +not known, and in the desktop app and other Android builds in every country. + Thank you for your support! ## Developer tools This page has options that normally are only needed for app developers and can be used to debug the app in case something is not working. +To open it, tap the app version at the end of **Advanced settings** in the app +settings, then **Developer** (iOS) or **Developer tools** (Android and desktop). + ### Chat console Here you can see and use console command with the chat core. None of this information is sent over the network, this is an internal communication between different parts of the app. @@ -220,8 +300,16 @@ Please be careful - some of the commands can disrupt app functioning, only use t ### Confirm database upgrades +This option is shown when [Show developer options](#show-developer-options) is +enabled. + This option is off by default - the app database is migrated to the new version without any confirmations. Starting from v4.6.2 these migrations are reversible - you can rollback to the previous version(s) of the app (not earlier than v4.6.1). If you want to be asked a confirmation every time database is upgraded you may enable this option - this is not recommended, as it happens almost on every app update, and should not cause any concerns. ### Show developer options -This option currently enables [Transport isolation mode](#transport-isolation-beta) option and also enables showing database IDs in contacts, groups and group members to simplify debugging via console commands. +This option currently enables [Transport isolation +mode](#transport-isolation-beta) option (on Android and desktop, its +**Connection** mode) and also enables showing database IDs in contacts, groups +and group members to simplify debugging via console commands. It also shows the +section **Developer options**, with [Confirm database +upgrades](#confirm-database-upgrades) and other options. diff --git a/docs/guide/audio-video-calls.md b/docs/guide/audio-video-calls.md index 8fc2bf95b2..914b563cee 100644 --- a/docs/guide/audio-video-calls.md +++ b/docs/guide/audio-video-calls.md @@ -1,21 +1,29 @@ --- -title: Audio & video Calls +title: Audio & video calls --- # Audio and Video Calls SimpleX Chat allows you to make end-to-end encrypted audio and video calls with your contacts via WebRTC. Note: Group calls are not supported at this time. +A call is end-to-end encrypted when both devices support it, and the call +screen shows its encryption status. + ## Making and accepting the calls ### How to make an audio call 1. Tap on a contact. -2. Tap on the phone icon to the right of your contact's name at the top of the screen. +2. Tap on the phone icon to the right of your contact's name in the chat toolbar, + and choose **Audio call**. The chat toolbar is at the top of the screen on + iOS, and at the bottom on Android and desktop by default. + +The phone icon is shown when the contact is connected and the **Audio/video +calls** preference allows calls with this contact. Calls are allowed by default. ### How to make a video call 1. Tap on a contact. -2. Tap on the three vertical dots on the top right-hand corner of the screen to access more options. +2. Tap on the phone icon to the right of your contact's name. 3. Choose **Video call**. ### Accepting the calls @@ -24,7 +32,9 @@ When there is an incoming call you have three options: - accept: to connect the call - reject: to reject the call, _without_ notifying the caller. -- ignore: to temporarily dismiss the call, but in a way that it can be accepted later, if the caller is still waiting, via the **Accept call** message in the conversation with this contact. +- ignore: to temporarily dismiss the call, but in a way that it can be accepted + later, if the caller is still waiting, via the **Answer call** message in the + conversation with this contact. There is no time limit that the call invitation can remain active - as long as the caller is still waiting, you can accept the call any time later. @@ -35,7 +45,7 @@ The call can be accepted from the lock screen, both on Android (it needs to be e SimpleX Chat shows an incoming call on your device's lock screen by default. However, you can change this behavior in the app settings menu. 1. Open the app settings menu. -2. Tap **Audio and Video calls**. +2. Tap **Audio & video calls**. 3. On the **Calls on lock screen** drop-down list, choose from the following three options: - Disable - the call will show as a notification. - Show - the call will show on the lock screen, you need to unlock the device and the app to accept it. @@ -45,41 +55,56 @@ SimpleX Chat shows an incoming call on your device's lock screen by default. How ### Calls on lock screen on iOS - - By default, SimpleX Chat uses native iOS call interface, where allowed, to show incoming calls on the lock screen. You can disable it: 1. Open the app settings menu. -2. Tap **Audio and Video calls**. +2. Tap **Audio & video calls**. 3. Toggle the **Use iOS call interface** switch off. **Please note**: iOS call interface allows accepting the calls without unlocking the device and the app. If this is undesirable, please disable it – the calls will show as notifications in this case. -Read more in [this post](../../blog/20230328-simplex-chat-v4-6-hidden-profiles.md#improved-audiovideo-calls). +### During a call + +On iOS and Android, the buttons on the call screen turn the microphone and the +camera on and off, switch the speaker, flip the camera and end the call. To use +the app during a call, tap the back button on the call screen. Tap the green bar +at the top of the app to return to the call. + +On desktop, the call opens in a tab of your default web browser. Closing the tab +ends the call. ## Advanced call settings ### WebRTC ICE servers - - SimpleX Chat uses a preset relay server to hide your IP address from your contacts by default, but it can also observe the duration of your calls. If you don't want that, you can configure and use your self-hosted WebRTC relay servers instead for further control of your calls. 1. Open the app settings menu. -2. Tap **Audio and Video calls**. +2. Tap **Audio & video calls**. 3. Tap **WebRTC ICE servers**. 4. Toggle the **Configure ICE servers** switch on. 5. Enter your ICE server addresses (one per line). 6. Tap **Save**. -**Please note**: unlike messaging relays (SMP servers), the configuration of WebRTC ICE servers is stored on the current device, not in the chat database. if you transfer the chat database to another device you need to update this configuration. +**Please note**: the configuration of WebRTC ICE servers is saved with the other +app settings in the exported chat database, and it is restored when you import +the database or migrate to another device. ### Always use relay Audio and video calls on SimpleX Chat are routed via a TURN relay server by default. Optionally you can disable this and use peer-to-peer (P2P) instead, when it is supported by your network. However, your IP address will be known to your contacts. 1. Open the app settings menu. -2. Tap **Audio and Video calls**. +2. Tap **Audio & video calls**. 3. Toggle the **Always use relay** switch on to use a relay server or off for P2P. -**Please note**: disabling this option allows P2P calls, but it does not prohibit the use of TURN relays – in case your network providers block P2P connections, the call will still use relays if the are available. To prohibit the use of relays you need to change WebRTC ICE server configuration to only include STUN servers, for example: +**Please note**: disabling this option allows P2P calls, but it does not prohibit +the use of TURN relays – in case your network providers block P2P connections, +the call will still use relays if they are available. To prohibit the use of +relays you need to change WebRTC ICE server configuration to only include STUN +servers, for example: + +``` +stuns:stun.simplex.im:443 +stun:stun.simplex.im:443 +``` diff --git a/docs/guide/channel-webpage.md b/docs/guide/channel-webpage.md index 8cb0f4fbe5..df6c1bb077 100644 --- a/docs/guide/channel-webpage.md +++ b/docs/guide/channel-webpage.md @@ -5,21 +5,31 @@ title: Channel webpage A channel webpage shows a preview of your channel on the web: its name, description, recent messages and subscriber count. Visitors can see what the channel is about before they subscribe, and the page gives them a "Join" button along with links to download the app. -You don't have to build the preview yourself. The chat relays that host your channel publish its content as a small file, and a ready-made script renders it on your page. All it takes is to copy the code the app generates and paste it into a web page you host. +The chat relays of your channel publish its content as a small file, and a +ready-made script renders it on your page. To set it up, copy the code the app +generates and paste it into a web page you host. ## What you need -A channel webpage can be set up by the **owner** of the channel, as long as the channel is hosted on chat relays that support webpages. If they don't, the app shows "Used chat relays do not support webpages." and no code is generated. +A channel webpage can be set up by the **owner** of the channel, as long as the +channel's chat relays support webpages. If they don't, the app shows "Used chat +relays do not support webpages." and no code is generated. -You'll also need somewhere to publish an HTML page. Your own site works, but any static hosting will do. +You'll also need somewhere to publish an HTML page: your own site or any static +hosting. ## Step 1. Open the channel webpage settings -Open the channel and tap its name at the top to open the channel information. Scroll down to **Advanced options** and tap **Channel webpage**. This button is only shown to channel owners. +Open the channel and tap its name in the chat toolbar to open the channel +information. The chat toolbar is at the top on iOS, and at the bottom on Android +and desktop by default. Scroll down to **Advanced options** and tap **Channel +webpage**. This button is only shown to channel owners. ## Step 2. Allow embedding while you build the page -Turn on **Allow anyone to embed** and tap **Save**. +Turn on **Allow anyone to embed** and tap **Save and notify subscribers** (iOS) +or **Save** (Android and desktop). On Android and desktop, the app closes the +screen after **Save**: tap **Channel webpage** again for the next step. With this on, the relay serves your channel preview to any page, so you can build and test from wherever the page lives without it being tied to one domain yet. Leave the webpage URL empty for now; nothing is shown to your subscribers until you set it. @@ -77,7 +87,7 @@ Once the page works, go back to **Channel webpage** in the app: - Under **Enter webpage URL**, type the address where the page is published, for example `https://example.com/my-channel`. - Turn **Allow anyone to embed** off if you don't want other sites to be able to show your channel preview. Leave it on if you're happy for anyone to embed it. -- Tap **Save**. +- Tap **Save and notify subscribers** (iOS) or **Save** (Android and desktop). The URL now appears as a link in your channel info that every subscriber can see. If you turned embedding off, the relay also restricts the preview to your own domain. @@ -95,6 +105,7 @@ You can add optional `data-*` attributes to the `
` to change how it looks. | `data-light-background` | CSS color | `#ffffff` | Background color in light mode. | | `data-dark-background` | CSS color | `#000832` | Background color in dark mode. | | `data-relay-scheme` | `https`, `http` | `https` | Protocol used to load the preview from the relays. Leave it as `https`. | +| `data-top-offset` | number of pixels | `0` | Space kept above the preview, for example for a fixed header of your page. | For example, here's a dark theme with a custom background and the download buttons hidden: @@ -116,12 +127,19 @@ The preview updates on its own. The relays republish channel content periodicall Only what the channel already shows publicly is included: recent messages, member display names and avatars, reactions, and the subscriber count. Deleted and disappearing messages are never published. -If your channel is served by more than one relay, all of them are listed in `data-relay-domains`. The script tries them in order, so the preview still loads when one relay is unavailable. +If more than one relay of your channel supports webpages, all of them are listed +in `data-relay-domains`. The script tries them in order, so the preview still +loads when one relay is unavailable. ## If something doesn't work -If the preview area stays empty, check that the page is hosted on the same domain as the URL you set in Step 5, or turn **Allow anyone to embed** back on while you sort it out. The relay only lets that domain load the preview. +If the preview area shows "Failed to load channel preview.", check that the page +is hosted on the same domain as the URL you set in Step 5, or turn **Allow anyone +to embed** back on while you sort it out. The relay only lets that domain load +the preview. -If the app says "Used chat relays do not support webpages.", the relays hosting your channel don't support this feature yet, so no code can be generated. +If the app says "Used chat relays do not support webpages.", the relays of your +channel don't support this feature yet, so no code can be generated. -If there's no **Channel webpage** button, remember that it only appears for channel owners on channels hosted on relays. +If there's no **Channel webpage** button, remember that it only appears for +channel owners. diff --git a/docs/guide/channels.md b/docs/guide/channels.md new file mode 100644 index 0000000000..9aac7a815b --- /dev/null +++ b/docs/guide/channels.md @@ -0,0 +1,245 @@ +--- +title: Channels +--- +# Channels + +With a channel, you publish messages to many subscribers. The owner posts as the +channel, and subscribers read the posts. Anyone with the channel link can +subscribe. + +Most channel settings are in the channel's chat info: tap the channel name in +the chat toolbar. The chat toolbar is at the top on iOS and at the bottom by +default on Android and desktop. + +## How channels work + +Chat relays deliver the messages of a channel. Each message is sent to the +channel's chat relays, and the relays forward it to the subscribers through +messaging servers. Subscribers do not connect directly to the chat relays, to +the owner or to each other, so the relays and the owner do not see their IP +addresses. + +A channel can have several chat relays, and its messages are delivered while at +least one of them is active. See [Chat relays](#chat-relays). + +Because anyone with the link can join a channel, channel messages are not +end-to-end encrypted, and chat relays can see them. The app shows a notice about +this at the start of each channel. Group messages are end-to-end encrypted, so +use a [group](./secret-groups.md) for private conversations. + +The channel profile is stored on subscribers' devices and on the chat relays. +The owner's chat profile is shared with the relays and the subscribers. + +The owner holds the channel's keys. Changes to the channel's profile, +preferences, relays and roles, and removals of members, are signed with the +owner's key, and subscribers' apps reject such changes without a valid +signature. Messages can also be signed, see [Message signing](#message-signing). + +## Create a channel + +Create public channel screen with the channel name field, Configure relays and Create public channel + +1. Tap the pencil button in the chat list, then tap **Create public channel**. +2. Tap the picture to add a channel image, and enter the channel name. +3. Tap **Create public channel**. + +**Configure relays** opens **Network & servers**, where you choose the chat +relays that the app can use. If no chat relay is enabled, **Configure relays** +is shown in orange, and the app asks you to enable at least one chat relay. + +The channel is created with your current chat profile, which is shared with the +chat relays and subscribers. The app picks up to 3 of your enabled chat relays +at random, preferring one of your own relays and relays of different server +operators. + +On the **Creating channel** screen, the app shows how many relays are active, +for example "2/3 relays active", and moves on when all of them are active. To +move on earlier, tap **Continue** when at least one relay is active. To delete +the new channel, tap **Cancel and delete channel**. + +Then the app shows the channel link and its QR code on the **Channel link** +screen. Share the link now or later, and tap **Continue** to open the channel. +On desktop, the app opens the channel and shows the channel link next to it. + +New channels have **Visible history** on and **Chat with admins** off. See +[Channel preferences](#channel-preferences). + +## Subscribe to a channel + +1. Open the channel link: tap it in a chat, paste it into the search field of + the chat list, or scan its QR code. To use the channel's SimpleX name, type + it into the search field and tap **Connect to …**. See [Connect via a link or + a name](./making-connections.md#connect-via-a-link-or-a-name). +2. The app shows the channel's name, image and number of subscribers. Tap **Open + channel**. +3. The app opens the channel with its welcome message, if it has one. The chat + relays, the owner and moderators see the profile you join with. To join with + another chat profile or incognito, choose it in **Your profile** above the + button. See [Incognito mode](./chat-profiles.md#incognito-mode). +4. Tap **Join channel**. + +The app connects to each of the channel's relays through messaging servers, and +you are subscribed when at least one relay connects. Until all relays connect, +the app shows the progress in a bar above the message field, for example "1/2 +relays connected". + +A channel card shared by the owner is marked "Channel link (from owner)". When +you open such a card, the app shows "Link signature verified." in the channel +preview. + +When a channel has no active relays, the app shows "Channel has no active +relays. Please try to join later." + +As a subscriber, you read the channel, and "you are subscriber" is shown in the +message field. You can react to messages when **Message reactions** is on, and +use **Chat with admins** when the owner turns it on. + +## Post in a channel + +As the owner, you post as the channel, and **Broadcast** is shown in the empty +message field. Subscribers see your posts with the channel's name and image, +marked "channel". + +Contributors and moderators post with their own chat profiles, and subscribers +see their names. + +Writing and sending messages is described in [Sending +messages](./send-messages.md#sending-messages). + +The owner and moderators have **Delete from history** (iOS) or **From history** +(Android and desktop) in place of **Delete for me**. It deletes the message on +your device. For a message that you posted, the chat relays also delete it from +the channel history that they keep: new subscribers do not receive it, and the +channel webpage does not show it. Subscribers who received the message earlier +keep it. + +## Channel link and name + +Anyone with the channel link can join the channel. + +- As the owner, tap **Channel link** in the chat info. The app shows the QR + code, **Share link** and **Share via chat**. Everyone who joins by the link + becomes a subscriber, and the link cannot be deleted. +- Other members see the QR code, **Share link** and **Share via chat** in the + chat info. + +With **Share via chat**, you choose a chat, and the app adds a channel card to +your message there. Recipients tap the card to open the channel. + +To let people find the channel by a name, the owner taps **Get SimpleX name +(BETA)** in the chat info, below the channel link. See [Registering a SimpleX +name](./register-simplex-name.md). + +To show a preview of the channel on a website, see [Channel +webpage](./channel-webpage.md). + +## Chat relays + +Chat relays forward channel messages to subscribers. The SimpleX Chat server +operator provides preset relays, and you can add your own. + +Tap **Chat relays** in the channel's chat info to see the relays and their +status. The owner sees each relay's state in the channel, for example +**active**. Other members see their connection to each relay, for example +**connected** or **connecting**. + +The owner can change the relays: + +- To add relays, tap **Add relay**, select relays, and tap **Add** (iOS) or + **Add relays** (Android and desktop). You can select from your enabled chat + relays that are not in the channel yet. +- To remove a relay, swipe it left (iOS), long-press it (Android) or right-click + it (desktop), and tap **Remove relay**. **Remove relay** is also in the + relay's info. For the last active relay, the app warns: "This is the last + active relay. Removing it will prevent message delivery to subscribers." + +When some relays are not active, the app shows their number in a bar above the +message field, for example "2/3 relays active, 1 failed" to the owner or "1/2 +relays connected" to subscribers. Tap the bar to see each relay. When no relay +works, the app shows "Add relays to restore message delivery." to the owner and +"Waiting for channel owner to add relays." to other members in the opened bar, +and "can't broadcast" in the message field of members who can post. + +The relays that the app can use are in **Network & servers**: in the **Chat +relays** section of a server operator, and in **Your servers**. To add your own +relay, open **Your servers**, tap **Add server**, then **Chat relay**, paste the +relay address, tap **Test relay**, and save with **Save servers**. A relay is +turned on or off with **Use for new channels**. See [Network & +servers](./app-settings.md#smp-servers). + +## Subscribers and roles + +| Role | What the member can do | +|---|---| +| Subscriber | Reads posts. Reacts when **Message reactions** is on. Uses **Chat with admins** when it is on. | +| Contributor | Also posts messages with their own name. | +| Moderator | Also deletes messages of contributors, blocks subscribers and contributors for all, and answers subscribers in **Chats with members**. | +| Owner | Posts as the channel. Edits the channel profile, welcome message and preferences. Manages relays and roles. Removes subscribers. Deletes the channel. | + +The owner and moderators see the members in **Subscribers** in the chat info. +Other members see **Owners & contributors**. + +The owner can change a member's role to subscriber, contributor or moderator: + +1. In the chat info, tap **Subscribers**, then tap the member. +2. Choose the new role in **Change role**. +3. Tap **Change** to confirm. All subscribers are notified. + +A channel has one owner, the member who created it. The owner role cannot be +given to other members. A channel can have up to 256 contributors and +moderators. + +In the member's info, moderators and the owner can **Block for all**, and the +owner can **Remove subscriber**. + +## Message signing + +When the owner turns on **Sign messages** in [Channel +preferences](#channel-preferences), the apps of all members who post sign every +message, and subscribers' apps verify the signatures. New subscribers see +earlier messages as unsigned. + +A seal icon is shown next to the time of a signed and verified message. Its +**Info** has the line "Signed & verified", or "Signed" for your own messages. + +While signing is on, a red seal icon is shown on a message without a signature. +Such a message was sent before the channel started signing, or it may be fake. + +A message with an invalid signature, or an unsigned edit or deletion of a signed +message, is rejected, and "message rejected: bad signature" is shown in the +chat. + +## Channel preferences + +The owner changes channel preferences. Tap **Channel preferences** in the +chat info, change them, and tap **Save and notify subscribers** (iOS) or **Save +and notify channel subscribers** (Android and desktop). Other members see the +preferences without the switches. + +| Preference | When it is on | New channels | +|---|---|---| +| **Sign messages** | Messages are signed: see [Message signing](#message-signing). | off | +| **Disappearing messages** | New messages are deleted after the time set in **Delete after**. | off | +| **Delete for everyone** | Messages deleted by their senders are deleted for all subscribers. | off | +| **Message reactions** | All members, including subscribers, can react to messages. | on | +| **Visible history** | Up to 100 last messages are sent to new subscribers. | on | +| **Chat with admins** | Subscribers and contributors can chat with the owner and moderators. | off | + +Chats with admins in channels are not end-to-end encrypted, so turn them on only +with chat relays you trust. + +The owner also edits the channel's name, image and short description with +**Edit channel profile**, and the message for new subscribers with **Add welcome +message** (**Welcome message** once it is added). Profile changes are sent to +subscribers. + +## Leave or delete a channel + +- As a subscriber, contributor or moderator, tap **Leave channel** in the chat + info to leave. You stop receiving messages from the channel, and the chat + history stays on your device. After that, tap **Delete channel** to delete it + for you. +- The owner can delete the channel for all subscribers with **Delete channel**. + This cannot be undone. + +See also [Leaving a group](./secret-groups.md#leaving-a-group). diff --git a/docs/guide/chat-profiles.md b/docs/guide/chat-profiles.md index d20790037a..5f405c76d8 100644 --- a/docs/guide/chat-profiles.md +++ b/docs/guide/chat-profiles.md @@ -1,79 +1,103 @@ --- title: Chat profiles --- -# Your chat profiles +# Chat profiles ## Creating additional chat profiles -SimpleX Chat allows creating as many chat profiles as you like. Same as the first profile, they are only stored locally on your device. - - +SimpleX Chat allows creating as many chat profiles as you like. Same as the first +profile, they are stored on your device and shared only with your contacts. You +can use different profiles, for example for family and work, or one with a +pseudonym. All of them receive messages at the same time. To create an additional SimpleX Chat profile: -- [Open the app settings](./app-settings.md#opening-the-app-settings). +- Tap your profile image in the chat list toolbar to open the profile menu. - Select "Your chat profiles". -- Unlock option via fingerprint or PIN. -- Tap on "+ Add profile”. -- Create a new profile by inputting your display name and full name (optional). -- Tap on "Create". +- Tap on "Add profile". +- Unlock via fingerprint or PIN, if you have [SimpleX + Lock](./app-settings.md#simplex-lock) enabled. +- Create a new profile by inputting your display name, and optionally a bio and + a profile image. +- Tap on "Create profile". ## Hiding and muting chat profiles v4.6 added the ability to mute and to hide chat profiles. -       +Hide profile screen with the fields Password to show and Confirm password -These actions are available via long-press (Android) or swipe (iOS) on the profile in the list. +These actions are available via long-press (Android), swipe right (iOS) or +right-click (desktop) on the profile in the list. -To unhide hidden profiles, enter the full password in the search bar. +To show hidden profiles, enter the full password in the search bar of "Your chat +profiles". Tap the profile to use it, or choose "Unhide" to unhide it. ## Switching between profiles - - -- Tap on your user profile image in the upper right-hand of the screen. +- Tap on your user profile image in the lower left-hand of the screen (upper + left, when the toolbar is at the top). - Select which profile you want to use. -You can also switch profile via Your chat profiles in the settings. +You can also switch profile via "Your chat profiles" in the same menu. ## Incognito mode - - This feature is unique to SimpleX Chat – it is independent from chat profiles. -When "Incognito Mode” is turned on, your currently chosen profile name and image are hidden from your new contacts. It allows anonymous connections with other people without any shared data – when you make new connections or join groups via a link a new random profile name will be generated for each connection. +When you choose "Incognito" for a new connection, your currently chosen profile +name and image are hidden from this contact, group or channel. It allows +anonymous connections with other people without any shared data – a new random +profile name will be generated for each connection. When you share an incognito +profile with somebody, this profile will also be used for the groups they invite +you to. -To toggle the incognito mode on/off: +To choose incognito mode: -- [Open the app settings](./app-settings.md#opening-the-app-settings). -- Turn on/off incognito mode by tapping on the switch on "Incognito". +- When you create a 1-time link, tap your profile under "Share profile" and + choose "Incognito". +- When you connect via a link, tap your profile under "Your profile" in the new + chat and choose "Incognito", before you tap "Connect", "Join group" or "Join + channel". For some links, the app asks you to choose "Use current profile" or + "Use new incognito profile" instead. +- When you create a group, turn on "Incognito". -Please read more in [this post](../../blog/20220901-simplex-chat-v3.2-incognito-mode.md#incognito-mode). +The app remembers your last choice for the next connection. ## Edit your profile To edit your profile: -- [Open the app settings](./app-settings.md#opening-the-app-settings). +- Tap your profile image in the chat list toolbar to open the profile menu. - Select your profile. -- Tap on "Edit". -- Input your desired profile name and/or update your full name. +- Input your desired profile name and/or update your bio. You can also add or + edit a description. - You can also set and change profile image. -- Tap on "Save and notify contacts". +- Tap on "Save (and notify contacts)" (iOS) or "Save and notify contacts" + (Android and desktop). ## Move your chat profiles to another device -SimpleX Chat stores all user data only on client devices using a portable encrypted database format that can be exported and transferred to any supported device. +SimpleX Chat stores all user data on client devices using a portable encrypted +database format that can be exported and transferred to any supported device. + +You can move all profiles with "Migrate to another device" in the app settings: +the app uploads the encrypted database, and the new device downloads it after +you scan a QR code or paste a link, see [Migrate to another +device](./managing-data.md#migrate-to-another-device). You can also export the +database to a file and import it on the new device. To export your SimpleX Chat data: - [Open the app settings](./app-settings.md#opening-the-app-settings). -- Select "Database passphrase & export". +- Select "Chat data", then "Database passphrase & export". - Stop chat by toggling "Chat is running" (tap "Stop” in the confirmation dialog). - Confirm it with fingerprint or PIN, in case you have [SimpleX Lock](./app-settings.md#simplex-lock) enabled. -- If you didn't set it before, [set a passphrase](./managing-data.md#database-passphrase) in "Database passphrase". Initially, the database is encrypted with a random passphrase that is stored in KeyChain (iOS) or with KeyStore (Android). +- If you didn't set it before, [set a + passphrase](./managing-data.md#database-passphrase) in "Database passphrase". + Initially, the database is encrypted with a random passphrase that is stored + in Keychain (iOS), with Keystore (Android) or in the app settings as plaintext + (desktop). - Tap on "Export database" - it won't allow exporting unless you have set a passphrase. - Save the file on your device or share it via any available option. @@ -81,9 +105,11 @@ To import your SimpleX Chat data in the app on another device: - Transfer the database file to the new device. - Install SimpleX Chat app. -- Create chat profile with any name by following the steps in [Create your first chat profile](#create-yout-first-chat-profile) – you will replace it soon. +- Create chat profile with any name by following the steps in [Create your first + chat profile](./README.md#create-your-first-chat-profile) – you will replace + it soon. - Open the app settings -- Select "Database passphrase & export". +- Select "Chat data", then "Database passphrase & export". - Stop chat by tapping the switch on "Chat is running". - Tap "Import database". - Select the .zip file of the exported chat data. @@ -94,6 +120,6 @@ To import your SimpleX Chat data in the app on another device: 1. Currently you cannot move some of the profiles, only the whole database containing all profiles can be moved. -2. You must NOT use the exported database on more than one device at a time, as it may disrupt some of the connections. You also must always use the latest version of the chat database - using the old one is also likely to disrupt your connections. +2. You must not use the exported database on more than one device at a time, as it may disrupt some of the connections. You also must always use the latest version of the chat database - using the old one is also likely to disrupt your connections. 3. There is no way to recover lost passphrase - make sure to store it securely. diff --git a/docs/guide/images/app-settings-advanced-network-settings.png b/docs/guide/images/app-settings-advanced-network-settings.png new file mode 100644 index 0000000000000000000000000000000000000000..54865644b0af4339a4ed387257e47f6ea241339f GIT binary patch literal 144656 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

@+oAMiT(INzV1Vm$E=psehqadQHJxY1~~<>lzaf z5E5xs{8q(C_}nNNh(`|eoTZXww5@#edOMgR@w}bd)+xk9l-uf@2Io}u*OhB?g>`)U ziTnKn6e96}0E@3a!91_B-V<_O%3A5`{+ew5d+Rv6K^0)#$cd;MChz%-L~5Z{)qscz zi9b6B$9n+WQs0=V=9VOR0fBU{Ol}1y1W)qHdG5ZWh$nkzl5^lp#ZJk?@salVxL>Jy zsAjqtEoln+^L|8c>sC~WNc(DD)IF0(pNSlPGGf`}{p(4A$1n2pP+M$I)~Oq~*uTsH zE&ljv&ak%Zm_}s6qO6@w9)}E}EFQOG_?*D2yO~vKIIRRzAH03%nhw2=3tHn^Q*j5d zx#o`l@^YdESS^Yhj$ME5S1uhnzJrC)eV^p|I?>3Y|E6j~k2SH$7GL>Z{J|ZvakD540Ntaj&LbSN3}*-u|i2eb?u~>ftjvckqbS6|gWxT;&6r{a!_-PVA46DsAtPSv^g)aqA-OZo1PgTo;^McHp; z2?968&})Ulq9t;N>)gNzT}yGGN1|>KMfEzTQ!-X_13JeIox1%wra|_2j?gWjC+ zPn}#l?$Jz5SrT#pT1N%Ue(O)H%*0auk*6|9P(rb#Xp2oQiNla!({%b~Z1Jk0uKhx- z&e}tzT;u&b^%q8kibEuM*l=y^{{x@b)W?fOg zxs&RKJ)y`P^a;k?w+-&{$DaB%(IFe-T{Ri$PviLy$$FeUzHh7KD|nbs$LMCq3e`Er zmwg?K#mkcEUP((!JEEl6gTjunnjAMn3zs)k800^vx6AdvagaCrNER4zMNR5DSfo)? zS?{tx>E_9!vsduB;tWF7jpU?frvEIjo&mC5MT6}#~UFc;e zkF9r--)7s#m1ZYei4){57=1Hd}f&fEjm}S^Uj?w$rTj&s_13mxHZE%k9w^1 zliX*c(fMzB!+64?=ZxuKF1@z6BTdV9UzZe*BR;HXK9>s8UXRS12IOUjr{!d+M#%Fywz0&EOkwi

VYfC@7!y$b&U`ZBF8x4+?3X-lxxaXH{o6^? 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