forked from cwtch.im/docs.cwtch.im
first pass of german translations (12% - old upload to crowdin)
This commit is contained in:
parent
a592b46946
commit
cca2f88b00
|
|
@ -15,7 +15,7 @@ the [Group Experiment](/docs/settings/experiments/group-experiment) turned on.
|
|||
will likely change in the future.**
|
||||
|
||||
By default, Cwtch only supports peer-to-peer, online, chat. In order to support multi-party conversations, and offline
|
||||
delivery, an (untrusted) third-party is required. We call these entities ["servers"](/docs/servers)
|
||||
delivery, an (untrusted) third-party is required. We call these entities ["servers"](/docs/servers/introduction)
|
||||
|
||||
These servers can be set up by anyone and are intended to be always online. Most importantly, all communication with a
|
||||
server is designed such that the server learns as little information as possible about the contents or metadata.
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ const config = {
|
|||
// to replace "en" with "zh-Hans".
|
||||
i18n: {
|
||||
defaultLocale: 'en',
|
||||
locales: ['en']
|
||||
locales: ['en', 'de']
|
||||
// Planned future versions to add. removing to start cus each needs a compile on push, no point compiling untranslated dups
|
||||
//, 'fr', 'da', 'de', 'it', 'no', 'pl', 'ro', 'ru', 'es-ES', 'cy'],
|
||||
},
|
||||
|
|
|
|||
|
|
@ -0,0 +1,233 @@
|
|||
{
|
||||
"theme.ErrorPageContent.title": {
|
||||
"message": "Diese Seite ist abgestürzt.",
|
||||
"description": "The title of the fallback page when the page crashed"
|
||||
},
|
||||
"theme.ErrorPageContent.tryAgain": {
|
||||
"message": "Erneut versuchen",
|
||||
"description": "The label of the button to try again when the page crashed"
|
||||
},
|
||||
"theme.NotFound.title": {
|
||||
"message": "Seite nicht gefunden",
|
||||
"description": "The title of the 404 page"
|
||||
},
|
||||
"theme.NotFound.p1": {
|
||||
"message": "Wir konnten leider nicht finden, wonach du gesucht hast.",
|
||||
"description": "The first paragraph of the 404 page"
|
||||
},
|
||||
"theme.NotFound.p2": {
|
||||
"message": "Bitte kontaktiere den/die Besitzer*in der Seite, die dich mit der ursprünglichen URL verlinkt hat, und teile mit, dass der Link nicht mehr funktioniert.",
|
||||
"description": "The 2nd paragraph of the 404 page"
|
||||
},
|
||||
"theme.BackToTopButton.buttonAriaLabel": {
|
||||
"message": "Zurück nach oben springen",
|
||||
"description": "The ARIA label for the back to top button"
|
||||
},
|
||||
"theme.blog.archive.title": {
|
||||
"message": "Archiv",
|
||||
"description": "The page & hero title of the blog archive page"
|
||||
},
|
||||
"theme.blog.archive.description": {
|
||||
"message": "Archiv",
|
||||
"description": "The page & hero description of the blog archive page"
|
||||
},
|
||||
"theme.AnnouncementBar.closeButtonAriaLabel": {
|
||||
"message": "Schliessen",
|
||||
"description": "The ARIA label for close button of announcement bar"
|
||||
},
|
||||
"theme.blog.paginator.navAriaLabel": {
|
||||
"message": "Navigation der Blogs",
|
||||
"description": "The ARIA label for the blog pagination"
|
||||
},
|
||||
"theme.blog.paginator.newerEntries": {
|
||||
"message": "Neuere Einträge",
|
||||
"description": "The label used to navigate to the newer blog posts page (previous page)"
|
||||
},
|
||||
"theme.blog.paginator.olderEntries": {
|
||||
"message": "Ältere Einträge",
|
||||
"description": "The label used to navigate to the older blog posts page (next page)"
|
||||
},
|
||||
"theme.blog.post.readingTime.plurals": {
|
||||
"message": "Eine Minute Lesezeit|{readingTime} Minuten Lesezeit",
|
||||
"description": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
|
||||
},
|
||||
"theme.blog.post.readMoreLabel": {
|
||||
"message": "Mehr über {title} lesen",
|
||||
"description": "The ARIA label for the link to full blog posts from excerpts"
|
||||
},
|
||||
"theme.blog.post.readMore": {
|
||||
"message": "Mehr lesen",
|
||||
"description": "The label used in blog post item excerpts to link to full blog posts"
|
||||
},
|
||||
"theme.blog.post.paginator.navAriaLabel": {
|
||||
"message": "Blog Post Seiten Navigation",
|
||||
"description": "The ARIA label for the blog posts pagination"
|
||||
},
|
||||
"theme.blog.post.paginator.newerPost": {
|
||||
"message": "Neuerer Beitrag",
|
||||
"description": "The blog post button label to navigate to the newer/previous post"
|
||||
},
|
||||
"theme.blog.post.paginator.olderPost": {
|
||||
"message": "Älterer Beitrag",
|
||||
"description": "The blog post button label to navigate to the older/next post"
|
||||
},
|
||||
"theme.blog.post.plurals": {
|
||||
"message": "Ein Beitrag|{count} Beiträge",
|
||||
"description": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
|
||||
},
|
||||
"theme.blog.tagTitle": {
|
||||
"message": "{nPosts} markiert mit \"{tagName}\"",
|
||||
"description": "The title of the page for a blog tag"
|
||||
},
|
||||
"theme.tags.tagsPageLink": {
|
||||
"message": "Alle Schlagwörter anzeigen",
|
||||
"description": "The label of the link targeting the tag list page"
|
||||
},
|
||||
"theme.colorToggle.ariaLabel": {
|
||||
"message": "Zwischen Dunkel- und Hellmodus wechseln (derzeit {mode})",
|
||||
"description": "The ARIA label for the navbar color mode toggle"
|
||||
},
|
||||
"theme.colorToggle.ariaLabel.mode.dark": {
|
||||
"message": "dunkler Modus",
|
||||
"description": "The name for the dark color mode"
|
||||
},
|
||||
"theme.colorToggle.ariaLabel.mode.light": {
|
||||
"message": "heller Modus",
|
||||
"description": "The name for the light color mode"
|
||||
},
|
||||
"theme.docs.breadcrumbs.home": {
|
||||
"message": "Startseite",
|
||||
"description": "The ARIA label for the home page in the breadcrumbs"
|
||||
},
|
||||
"theme.docs.breadcrumbs.navAriaLabel": {
|
||||
"message": "Breadcrumbs",
|
||||
"description": "The ARIA label for the breadcrumbs"
|
||||
},
|
||||
"theme.docs.DocCard.categoryDescription": {
|
||||
"message": "{count} Elemente",
|
||||
"description": "The default description for a category card in the generated index about how many items this category includes"
|
||||
},
|
||||
"theme.docs.paginator.navAriaLabel": {
|
||||
"message": "Navigation der Dokumentationsseiten",
|
||||
"description": "The ARIA label for the docs pagination"
|
||||
},
|
||||
"theme.docs.paginator.previous": {
|
||||
"message": "Vorherige",
|
||||
"description": "The label used to navigate to the previous doc"
|
||||
},
|
||||
"theme.docs.paginator.next": {
|
||||
"message": "Nächste",
|
||||
"description": "The label used to navigate to the next doc"
|
||||
},
|
||||
"theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel": {
|
||||
"message": "Einklappbare Seitenleistenkategorie \"{label}\" umschalten",
|
||||
"description": "The ARIA label to toggle the collapsible sidebar category"
|
||||
},
|
||||
"theme.docs.tagDocListPageTitle.nDocsTagged": {
|
||||
"message": "Ein Dokument markiert|{count} Dokumente markiert",
|
||||
"description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)"
|
||||
},
|
||||
"theme.docs.tagDocListPageTitle": {
|
||||
"message": "{nDocsTagged} markiert mit \"{tagName}\"",
|
||||
"description": "The title of the page for a docs tag"
|
||||
},
|
||||
"theme.docs.versionBadge.label": {
|
||||
"message": "Version: {versionLabel}"
|
||||
},
|
||||
"theme.docs.versions.unreleasedVersionLabel": {
|
||||
"message": "Dies ist eine unveröffentlichte Dokumentation für die Version {siteTitle} {versionLabel}.",
|
||||
"description": "The label used to tell the user that he's browsing an unreleased doc version"
|
||||
},
|
||||
"theme.docs.versions.unmaintainedVersionLabel": {
|
||||
"message": "Dies ist eine Dokumentation für {siteTitle} {versionLabel}, die nicht mehr aktiv gepflegt wird.",
|
||||
"description": "The label used to tell the user that he's browsing an unmaintained doc version"
|
||||
},
|
||||
"theme.docs.versions.latestVersionSuggestionLabel": {
|
||||
"message": "Für die aktuellste Dokumentation bitte auf {latestVersionLink} ({versionLabel}) gehen.",
|
||||
"description": "The label used to tell the user to check the latest version"
|
||||
},
|
||||
"theme.docs.versions.latestVersionLinkLabel": {
|
||||
"message": "aktuelle Version",
|
||||
"description": "The label used for the latest version suggestion link label"
|
||||
},
|
||||
"theme.common.editThisPage": {
|
||||
"message": "Diese Seite bearbeiten",
|
||||
"description": "The link label to edit the current page"
|
||||
},
|
||||
"theme.common.headingLinkTitle": {
|
||||
"message": "Direkter Link zur Überschrift",
|
||||
"description": "Title for link to heading"
|
||||
},
|
||||
"theme.lastUpdated.atDate": {
|
||||
"message": " am {date}",
|
||||
"description": "The words used to describe on which date a page has been last updated"
|
||||
},
|
||||
"theme.lastUpdated.byUser": {
|
||||
"message": " von {user}",
|
||||
"description": "The words used to describe by who the page has been last updated"
|
||||
},
|
||||
"theme.lastUpdated.lastUpdatedAtBy": {
|
||||
"message": "Zuletzt aktualisiert {atDate} {byUser}",
|
||||
"description": "The sentence used to display when a page has been last updated, and by who"
|
||||
},
|
||||
"theme.navbar.mobileVersionsDropdown.label": {
|
||||
"message": "Versionen",
|
||||
"description": "The label for the navbar versions dropdown on mobile view"
|
||||
},
|
||||
"theme.common.skipToMainContent": {
|
||||
"message": "Zum Hauptinhalt springen",
|
||||
"description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation"
|
||||
},
|
||||
"theme.TOCCollapsible.toggleButtonLabel": {
|
||||
"message": "Auf dieser Seite",
|
||||
"description": "The label used by the button on the collapsible TOC component"
|
||||
},
|
||||
"theme.tags.tagsListLabel": {
|
||||
"message": "Schlagwörter:",
|
||||
"description": "The label alongside a tag list"
|
||||
},
|
||||
"theme.blog.sidebar.navAriaLabel": {
|
||||
"message": "Navigation der letzten Blogbeiträge",
|
||||
"description": "The ARIA label for recent posts in the blog sidebar"
|
||||
},
|
||||
"theme.CodeBlock.copied": {
|
||||
"message": "Kopiert",
|
||||
"description": "The copied button label on code blocks"
|
||||
},
|
||||
"theme.CodeBlock.copyButtonAriaLabel": {
|
||||
"message": "Code in die Zwischenablage kopieren",
|
||||
"description": "The ARIA label for copy code blocks button"
|
||||
},
|
||||
"theme.CodeBlock.copy": {
|
||||
"message": "Kopieren",
|
||||
"description": "The copy button label on code blocks"
|
||||
},
|
||||
"theme.CodeBlock.wordWrapToggle": {
|
||||
"message": "Zeilenumbruch ein-/ausschalten",
|
||||
"description": "The title attribute for toggle word wrapping button of code block lines"
|
||||
},
|
||||
"theme.navbar.mobileLanguageDropdown.label": {
|
||||
"message": "Sprachen",
|
||||
"description": "The label for the mobile language switcher dropdown"
|
||||
},
|
||||
"theme.docs.sidebar.collapseButtonTitle": {
|
||||
"message": "Seitenleiste ausblenden",
|
||||
"description": "The title attribute for collapse button of doc sidebar"
|
||||
},
|
||||
"theme.docs.sidebar.collapseButtonAriaLabel": {
|
||||
"message": "Seitenleiste ausblenden",
|
||||
"description": "The title attribute for collapse button of doc sidebar"
|
||||
},
|
||||
"theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": {
|
||||
"message": "← Zurück zum Hauptmenü",
|
||||
"description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)"
|
||||
},
|
||||
"theme.docs.sidebar.expandButtonTitle": {
|
||||
"message": "Seitenleiste einblenden",
|
||||
"description": "The ARIA label and title attribute for expand button of doc sidebar"
|
||||
},
|
||||
"theme.docs.sidebar.expandButtonAriaLabel": {
|
||||
"message": "Seitenleiste einblenden",
|
||||
"description": "The ARIA label and title attribute for expand button of doc sidebar"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
{
|
||||
"title": {
|
||||
"message": "Blog",
|
||||
"description": "The title for the blog used in SEO"
|
||||
},
|
||||
"description": {
|
||||
"message": "Blog",
|
||||
"description": "The description for the blog used in SEO"
|
||||
},
|
||||
"sidebar.title": {
|
||||
"message": "Kürzliche Beiträge",
|
||||
"description": "The label for the left sidebar"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
{
|
||||
"version.label": {
|
||||
"message": "Nächste",
|
||||
"description": "The label for version current"
|
||||
},
|
||||
"sidebar.tutorialSidebar.category.Profiles": {
|
||||
"message": "Profile",
|
||||
"description": "The label for category Profiles in sidebar tutorialSidebar"
|
||||
},
|
||||
"sidebar.tutorialSidebar.category.Chat": {
|
||||
"message": "Chat",
|
||||
"description": "The label for category Chat in sidebar tutorialSidebar"
|
||||
},
|
||||
"sidebar.tutorialSidebar.category.Settings": {
|
||||
"message": "Einstellungen",
|
||||
"description": "The label for category Settings in sidebar tutorialSidebar"
|
||||
},
|
||||
"sidebar.tutorialSidebar.category.Appearance": {
|
||||
"message": "Darstellung",
|
||||
"description": "The label for category Appearance in sidebar tutorialSidebar"
|
||||
},
|
||||
"sidebar.tutorialSidebar.category.Behaviour": {
|
||||
"message": "Verhalten",
|
||||
"description": "The label for category Behaviour in sidebar tutorialSidebar"
|
||||
},
|
||||
"sidebar.tutorialSidebar.category.Contribute": {
|
||||
"message": "Mitwirken",
|
||||
"description": "The label for category Contribute in sidebar tutorialSidebar"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Conversations",
|
||||
"position": 3,
|
||||
"link": {
|
||||
"type": "generierter Index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Accepting/Denying New Conversations
|
||||
|
||||
1. Zu deinem Profil gehen
|
||||
2. Wenn dich jemand als Kontakt hinzugefügt hat, dann erscheint ein neuer Name und zwei Optionen
|
||||
1. Klicke auf das Herzsymbol um diese neue Verbindung zu akzeptieren
|
||||
2. Klicke auf das Papierkorb-Symbol, um sie zu blockieren
|
||||
|
||||
See also: [Setting: Block Unknown Connections](https://docs.cwtch.im/docs/settings/behaviour/block-unknown-connections)
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 1.5
|
||||
---
|
||||
|
||||
# Adding a New Contact
|
||||
|
||||
1. Select a Profile
|
||||
2. Click on the Add button
|
||||
3. Wähle 'Kontakt hinzufügen'
|
||||
5. Paste a Cwtch Address
|
||||
6. The contact will be added to your contacts list
|
||||
|
|
@ -0,0 +1,10 @@
|
|||
---
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
# Blocking a Contact
|
||||
|
||||
1. On a conversation window
|
||||
2. Go to Settings
|
||||
3. Scroll down to Block Contact
|
||||
4. Move the switch to Block Contact
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# An Introduction to Cwtch P2P Chat
|
||||
|
||||
Cwtch uses Tor v3 Onion Services to establish anonymous, peer-to-peer connections between Profiles.
|
||||
|
||||
## How P2P Chat Works Under the Hood
|
||||
|
||||
In order to chat with your friends in a peer-to-peer conversation both must be online.
|
||||
|
||||
After a successful connection both parties engage in an **authentication protocol** which:
|
||||
|
||||
* Asserts that each party has access to the private key associated with their public identity.
|
||||
* Generates an ephemeral session key used to encrypt all further communication during the session.
|
||||
|
||||
This exchange (documented in further detail in [authentication protocol](https://docs.openprivacy.ca/cwtch-security-handbook/authentication_protocol.html)) is *offline deniable* i.e. it is possible for any party to forge transcripts of this protocol exchange after the fact, and as such - after the fact - it is impossible to definitely prove that the exchange happened at all.
|
||||
|
||||
One the authentication process is successful then both you and your friend can communicate away assured that no one else can learn anything about the contents or the metadata if your conversation.
|
||||
|
|
@ -0,0 +1,22 @@
|
|||
---
|
||||
sidebar_position: 4.5
|
||||
---
|
||||
|
||||
# Message Formatting
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Message Formatting Experiment](https://docs.cwtch.im/docs/settings/experiments/message-formatting) turned on.
|
||||
|
||||
Optionally, you can enable [Clickable Links](https://docs.cwtch.im/docs/settings/experiments/clickable-links) to make URLs in messages clickable in Cwtch.
|
||||
|
||||
:::
|
||||
|
||||
Cwtch currently supports the following formatting markdown for messages:
|
||||
|
||||
* `**bold**` which will render **bold**
|
||||
* `*italic*` which will render *italic*
|
||||
* `code` which will render `code`
|
||||
* `^superscript^` which will render superscript
|
||||
* `_subscript_` which will render subscript
|
||||
* `~~strikthrough~~` which will render ~~strikethrough~~
|
||||
|
|
@ -0,0 +1,10 @@
|
|||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# Replying to a Message
|
||||
|
||||
1. Select a message you want to reply to
|
||||
2. Pull a message right
|
||||
3. Write an answer to the quoted message
|
||||
4. Hit send
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Saving Conversation History
|
||||
|
||||
By default, for privacy, Cwtch does not preserve conversation history between sessions.
|
||||
|
||||
To enable history for a specific conversation:
|
||||
|
||||
1. On a conversation window go to Settings
|
||||
2. Go to Save History
|
||||
3. Click the dropdown menu
|
||||
4. Pick Save History
|
||||
5. Now your history will be saved
|
||||
|
||||
Conversation history can be turned off at any point by selecting "Delete History" from the drop down menu.
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Sharing a Cwtch Address
|
||||
|
||||
1. Go to your profile
|
||||
2. Click the copy address icon
|
||||
|
||||
You can now share this address. People with this address will be able to add you as a Cwtch contact.
|
||||
|
||||
For information on blocking connections from people you don't know please see [Settings: Block Unknown Connections](/docs/settings/behaviour/block-unknown-connections)
|
||||
|
|
@ -0,0 +1,51 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
|
||||
# Sharing a File
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [File Sharing Experiment](https://docs.cwtch.im/docs/settings/experiments/file-sharing) turned on.
|
||||
|
||||
Optionally, you can enable [Image Previews and Profile Pictures](https://docs.cwtch.im/docs/settings/experiments/image-previews-and-profile-pictures) to see display shared image previews in the conversation window.
|
||||
|
||||
:::
|
||||
|
||||
In a Conversation,
|
||||
|
||||
1. Click on the attachment icon
|
||||
2. Find the file you want to send
|
||||
3. Confirm you want to send it
|
||||
|
||||
## How does file sharing with groups work? Are my files stored on a server somewhere?
|
||||
|
||||
Files are sent through onion-to-onion Cwtch connections directly from the person offering the file to the person receiving it. The initial offer to send a file is posted as a standard Cwtch conversation/overlay message. For groups, this means that the initial offer (containing the filename, size, hash, and a nonce) is posted to the group server, but then each recipient connects to you individually to receive the actual file contents.
|
||||
|
||||
## Does that mean I have to be online to send a file?
|
||||
|
||||
Yes. If the person offering the file goes offline, you will have to wait for them to come online to resume the file transfer. The underlying protocol splits the files into individually-requestable, verifiable chunks, so that in a future release you will be able to "rehost" a file posted to a group, and even download from multiple hosts at once (sort of like bittorrent).
|
||||
|
||||
## Why are new contacts popping up in my list?
|
||||
|
||||
This is due to how Cwtch currently handles connections from unknown addresses. Since posting a file to a group results in group members connecting to you directly, some of those members might not be in your contact list already and so their download connection to you will appear in your list as a contact request.
|
||||
|
||||
## What is "SHA512"?
|
||||
|
||||
SHA512 is a [cryptographic hash](https://en.wikipedia.org/wiki/Cryptographic_hash_function) that can be used to verify that the file you downloaded is a correct copy of the file that was offered. Cwtch does this verification for you automatically, but you're welcome to try it yourself! Note that we also include a random nonce with file offers, so people can't just ask you for any random hash you might have, or files from conversations they're not part of.
|
||||
|
||||
## Is there a file size limit?
|
||||
|
||||
The current limit is 10 gigabytes per file.
|
||||
|
||||
## What are these .manifest files?
|
||||
|
||||
The .manifest files are used while downloading the file to verify that individual chunks are received correctly, and support resuming interrupted transfers. They also contain the info from the original file offer. You can safely delete them once the download is complete. On Android, the manifests are stored in the app's cache, and can be cleared through your system settings.
|
||||
|
||||
## What about file metadata?
|
||||
|
||||
We send the file's name as a suggestion and to help distinguish it from other file offers. The full path is stripped before sending the offer. You should be wary of hidden metadata that might be stored in the file itself, which varies depending on the file's format. For example, images might contain geolocation info and information about the camera that took them, and PDF files are notorious for containing hidden information such as the author's name or the machine they were created on. In general, you should only send and receive files with people you trust.
|
||||
|
||||
## Can I download files automatically?
|
||||
|
||||
If the [Image Previews and Profile Pictures experiment](https://docs.cwtch.im/docs/settings/experiments/image-previews-and-profile-pictures) is enabled then Cwtch will automatically download images from accepted conversations
|
||||
|
|
@ -0,0 +1,10 @@
|
|||
---
|
||||
sidebar_position: 8
|
||||
---
|
||||
|
||||
# Unblocking a Contact
|
||||
|
||||
1. Select the contact in your Conversation list. Blocked contacts are moved to the bottom of the list.
|
||||
2. Go to Conversation Settings
|
||||
3. Scroll down to Block Contact
|
||||
4. Move the switch to Unblock Contact
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Mitwirken",
|
||||
"position": 10,
|
||||
"link": {
|
||||
"type": "generierter Index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Translate Cwtch
|
||||
|
||||
If you would like to contribute translations to Cwtch the application or this handbook here is how
|
||||
|
||||
## Cwtch Application
|
||||
|
||||
The application is translated through [Lokalise](https://lokalise.com).
|
||||
1. Sign up for an account on the site
|
||||
2. Email [team@cwtch.im](mailto:team@cwtch.im) that would like to translate and the email address you signed up with. We will add you to the project
|
||||
|
||||
## Cwtch User's Handbook
|
||||
|
||||
The handbook is translated through [Crowdin](https://crowdin.com).
|
||||
1. Sign up for an account on the site.
|
||||
2. Go to the [cwtch-users-handbook](https://crowdin.com/project/cwtch-users-handbook) project and join.
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Groups",
|
||||
"position": 4,
|
||||
"link": {
|
||||
"type": "generated-index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# Accepting a Group Invite
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Group Experiment](https://docs.cwtch.im/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
1. If a friend sends you a group request
|
||||
2. Choose if you want or not to join this group
|
||||
3. Now the group is on your contact list
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Group_acceptinvite.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Creating a New Group
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Group Experiment](https://docs.cwtch.im/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
1. On your contacts pane
|
||||
2. Press on the plus action button
|
||||
3. Press on Create Group
|
||||
4. Name your Group
|
||||
5. Press on Create
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Group_Create.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
---
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
# Editing a Group Name
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Group Experiment](https://docs.cwtch.im/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
Group names are private to you, it will not be shared, it is your local name for the group.
|
||||
|
||||
1. On the chat pane go to settings
|
||||
2. Change the name of the group
|
||||
3. Press the save button
|
||||
4. Now your group has a new name
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/group_edit.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,37 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# An Introduction to Cwtch Groups
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](/docs/settings/introduction#experiments) and the [Group Experiment](/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
**Note: Metadata Resistant Group Communication is still an active research area and what is documented here will likely change in the future.**
|
||||
|
||||
By default, Cwtch only supports peer-to-peer, online, chat. In order to support multi-party conversations, and offline delivery, an (untrusted) third-party is required. We call these entities ["servers"](/docs/servers/introduction)
|
||||
|
||||
These servers can be set up by anyone and are intended to be always online. Most importantly, all communication with a server is designed such that the server learns as little information as possible about the contents or metadata.
|
||||
|
||||
In many respects communication with a server is identical to communication with a regular Cwtch peer, all the same steps are taken however the server always acts as the inbound peer, and the outbound peer always uses newly generated **ephemeral keypair** - so that each server session is disconnected.
|
||||
|
||||
As such, peer-server conversations only differ in the *kinds* of messages that are sent between the two parties, with the server storing all messages that it receives and thus allowing any client to query for older messages.
|
||||
|
||||
The risk model associated with servers is more complicated that peer-to-peer communication, as such we currently require people who want to use servers within cwtch to [opt-in to the Group Chat experiment](/docs/settings/experiments/group-experiment) in order to add, manage and create groups on untrusted servers.
|
||||
|
||||
## How Groups Work Under the Hood
|
||||
|
||||
When a person wants to start a group conversation they first randomly generate a secret `Group Key`. All group communication will be encrypted using this key.
|
||||
|
||||
Along with the `Group Key`, the group creator also decides on a **Cwtch Server** to use as the host of the group. For more information on how Servers authenticate themselves see [key bundles](https://docs.openprivacy.ca/cwtch-security-handbook/key_bundles.html).
|
||||
|
||||
A `Group Identifier` is generated using the group key and the group server and these three elements are packaged up into an invite that can be sent to potential group members (e.g. over existing peer-to-peer connections).
|
||||
|
||||
To send a message to the group, a profile connects to the server hosting the group (see below), and encrypts their message using the `Group Key` and generates a cryptographic signature over the `Group Id`, `Group Server` and the decrypted message (see: [wire formats](https://docs.openprivacy.ca/cwtch-security-handbook/message_formats.html) for more information).
|
||||
|
||||
To receive message from the group, a profile connected to the server hosting the group and downloads *all* messages (since their previous connection). Profiles then attempt to decrypt each message using the `Group Key` and if successful attempt to verify the signature (see [Cwtch Servers](https://docs.openprivacy.ca/cwtch-security-handbook/server.html) [Cwtch Groups](https://docs.openprivacy.ca/cwtch-security-handbook/groups.html) for an overview of attacks and mitigations).
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
|
||||
# How to Leave a Group
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Group Experiment](https://docs.cwtch.im/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
:::warning
|
||||
|
||||
This feature will result in **irreversible** deletion of key material. This **cannot be undone**.
|
||||
|
||||
:::
|
||||
|
||||
1. On the chat pane go to settings
|
||||
2. Scroll down on the settings pane
|
||||
3. Press on leave conversation
|
||||
4. Confirm you want to leave
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Group_Leave.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
---
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
# Managing Servers
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Group Experiment](https://docs.cwtch.im/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
Cwtch groups are hosted by untrusted servers. If you want to see the servers you know about, their status, and the groups hosted on them:
|
||||
|
||||
1. On your contacts pane
|
||||
2. Got to the manage servers icon
|
||||
|
||||
## Import locally hosted server
|
||||
|
||||
1. To import a locally hosted server click on select local server
|
||||
2. Select the server you want
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Server_Manage.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Sending Invites to a Group
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Group Experiment](https://docs.cwtch.im/docs/settings/experiments/group-experiment) turned on.
|
||||
|
||||
:::
|
||||
|
||||
1. Go to a chat with a friend
|
||||
2. Press on the invite icon
|
||||
3. Select the group you want to invite them to
|
||||
4. Press Invite
|
||||
5. You have sent an invite
|
||||
|
||||
<div>
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Group_Invite.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# What is Cwtch?
|
||||
|
||||
Cwtch (/kʊtʃ/ - a Welsh word roughly translating to “a hug that creates a safe place”) is a decentralized, privacy-preserving, metadata resistant messaging app.
|
||||
|
||||
* **Decentralized and Open**: There is no “Cwtch service” or “Cwtch network”. Participants in Cwtch can host their own safe spaces, or lend their infrastructure to others seeking a safe space. The Cwtch protocol is open, and anyone is free to build bots, services and user interfaces and integrate and interact with Cwtch.
|
||||
* **Privacy Preserving**: All communication in Cwtch is end-to-end encrypted and takes place over Tor v3 onion services.
|
||||
* **Metadata Resistant**: Cwtch has been designed such that no information is exchanged or available to anyone without their explicit consent, including on-the-wire messages and protocol metadata.
|
||||
|
||||
|
||||
# Security, Encryption and Safety
|
||||
|
||||
For a more in depth look at the security, privacy, and underlying encryption technology used in Cwtch, please consult our [Security Handbook](https://docs.openprivacy.ca/cwtch-security-handbook/)
|
||||
|
||||
# Getting Started
|
||||
|
||||
You can download the latest version of Cwtch from [https://cwtch.im/download/](https://cwtch.im/download/)
|
||||
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Profile",
|
||||
"position": 2,
|
||||
"link": {
|
||||
"type": "generierter Index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Changing Your Display Name
|
||||
|
||||
1. On the Manage Profiles view, Press the pencil next to the profile you want to edit
|
||||
2. Ändere deinen Namen
|
||||
3. Profil speichern klicken
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Changing Your Password
|
||||
|
||||
1. Drücke den Stift neben dem Profil, das du bearbeiten möchtest
|
||||
2. Gehe zum aktuellen Passwort und gib dein aktuelles Passwort ein
|
||||
3. Gehe zu neuem Passwort und gib dein neues Passwort ein
|
||||
4. Passwort erneut eingeben
|
||||
5. Profil speichern klicken
|
||||
|
|
@ -0,0 +1,16 @@
|
|||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Changing Your Profile Image
|
||||
|
||||
:::caution
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and both the [File Sharing](https://docs.cwtch.im/docs/settings/experiments/file-sharing) and [Image Previews and Profile Pictures](https://docs.cwtch.im/docs/settings/experiments/image-previews-and-profile-pictures) enabled.
|
||||
|
||||
:::
|
||||
|
||||
1. Press the pencil next to the profile you want to edit
|
||||
2. Press on the pink pencil over your profile photo
|
||||
3. Select an image from your device
|
||||
4. Scroll down and click on save profile
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
---
|
||||
sidebar_position: 1.5
|
||||
---
|
||||
|
||||
# Creating a New Profile
|
||||
|
||||
1. Press the `+` action button in the right bottom corner and select "New Profile"
|
||||
2. Wähle einen Anzeigenamen
|
||||
3. Select if you want to protect this profile locally with strong encryption:
|
||||
- Password: your account is protected from other people who may use this device
|
||||
- No Password: anyone who has access to this device may be able to access this profile
|
||||
4. Fill in your password and re-enter it
|
||||
5. Click add new profile
|
||||
|
||||
## A note on Password Protected (Encrypted) Profiles
|
||||
|
||||
Profiles are stored locally on disk and encrypted using a key derived from user-known password (via pbkdf2).
|
||||
|
||||
Note that once encrypted, and stored on disk, the only way to recover a profile is by rederiving the password - as such it isn't possible to provide a full list of profiles a user might have access to until they enter a password.
|
||||
|
||||
See also: [Cwtch Security Handbook: Profile Encryption & Storage](https://docs.openprivacy.ca/cwtch-security-handbook/profile_encryption_and_storage.html)
|
||||
|
|
@ -0,0 +1,16 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
|
||||
# Deleting a Profile
|
||||
|
||||
:::warning
|
||||
|
||||
This feature will result in **irreversible** deletion of key material. This **cannot be undone**.
|
||||
|
||||
:::
|
||||
|
||||
1. Drücke den Stift neben dem Profil, das du bearbeiten möchtest
|
||||
2. Scrolle nach unten zum Ende des Bildschirms
|
||||
3. Löschen drücken
|
||||
4. Drücke wirklich Profil löschen
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
sidebar_position: 10
|
||||
---
|
||||
|
||||
# Backup or Exporting a Profile
|
||||
|
||||
On the Profile Management Screen:
|
||||
|
||||
1. Select the pencil next to the profile you want to edit
|
||||
2. Scroll down to the bottom of the screen
|
||||
3. Select "Export Profile"
|
||||
4. Choose a location, and a file name
|
||||
5. Confirm
|
||||
|
||||
Once confirmed, Cwtch will place a copy of the profile at the given location. This file is encrypted to the same level that the profile is. See [A note on Password Protected (Encrypted) Profiles](/docs/profiles/create-a-profile#a-note-on-password-protected-encrypted-profiles) for more information on encrypted profiles.
|
||||
|
||||
This file can be [imported](/docs/profiles/importing-a-profile) into another instance of Cwtch on any device.
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
---
|
||||
sidebar_position: 11
|
||||
---
|
||||
|
||||
# Importing a Profile
|
||||
|
||||
1. Press the `+` action button in the right bottom corner and select "Import Profile"
|
||||
2. Select an [exported Cwtch profile file](/docs/profiles/exporting-profile) to import
|
||||
3. Enter the [password](/docs/profiles/create-a-profile#a-note-on-password-protected-encrypted-profiles) associated with the profile and confirm.
|
||||
|
||||
Once confirmed, Cwtch will attempt to decrypt the provided file using a key derived from the given password. If successful the profile will appear on the Profile Management screen and will be ready to use.
|
||||
|
||||
:::note
|
||||
|
||||
While a profile can be imported onto multiple devices, currently only one version of a profile can be in-use across all devices at any one time.
|
||||
|
||||
Attempts to use the same profile across multiple devices may result in availability issues and messaging failures.
|
||||
|
||||
:::
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# An Introduction to Cwtch Profiles
|
||||
|
||||
With Cwtch you can create one of more **Profiles**. Each profile generates a random ed25519 keypair compatible with the Tor Network.
|
||||
|
||||
This is the identifier that you can give out to people and that they can use to contact you via Cwtch.
|
||||
|
||||
Cwtch allows you to create and manage multiple, separate profiles. Each profile is associated with a different key pair which launches a different onion service.
|
||||
|
||||
## Manage Profiles
|
||||
|
||||
On start up Cwtch will launch the Manage Profiles screen. From this screen you can:
|
||||
|
||||
- [Create a New Profile](https://docs.cwtch.im/docs/profiles/create-a-profile)
|
||||
- [Unlock Existing Encrypted Profiles](https://docs.cwtch.im/docs/profiles/unlock-profile)
|
||||
- Manage Loaded Profiles
|
||||
- [Changing The Display Name of a Profile](https://docs.cwtch.im/docs/profiles/change-name/)
|
||||
- [Changing the Password of a Profile](https://docs.cwtch.im/docs/profiles/change-password/)
|
||||
- [Deleting a Profile](https://docs.cwtch.im/docs/profiles/delete-profile)
|
||||
- [Changing a Profile Image](https://docs.cwtch.im/docs/profiles/change-profile-image/)
|
||||
|
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# Unlocking Encrypted Profiles
|
||||
|
||||
When you restart Cwtch, if you used a [password](/docs/profiles/change-password/) to protect your profile, it will not be loaded by default, and you will need to unlock it.
|
||||
|
||||
1. Press the pink unlock icon <img src="/img/lock_open-24px.webp" className="ui-button" alt="unlock icon" />
|
||||
2. Kennwort eingeben
|
||||
3. Klicke auf "Profil entsperren"
|
||||
|
||||
See also: [Cwtch Security Handbook: Profile Encryption & Storage](https://docs.openprivacy.ca/cwtch-security-handbook/profile_encryption_and_storage.html)
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Servers",
|
||||
"position": 4,
|
||||
"link": {
|
||||
"type": "generated-index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# How to create a server
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Server Hosting Experiment](https://docs.cwtch.im/docs/settings/experiments/server-hosting) turned on.
|
||||
|
||||
:::
|
||||
|
||||
1. Go to the server icon
|
||||
2. Press the + action button to make a new server
|
||||
3. Choose a name for your server
|
||||
4. Select a password for your server
|
||||
5. Click on “Add Server”
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Server_New.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# How to delete server
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Server Hosting Experiment](https://docs.cwtch.im/docs/settings/experiments/server-hosting) turned on.
|
||||
|
||||
:::
|
||||
|
||||
|
||||
1. Go to the server Icon
|
||||
2. Select the server you want to delete
|
||||
3. Press the pencil icon
|
||||
4. Scroll down and input your password
|
||||
5. Press delete
|
||||
6. Press really delete
|
||||
7. Your server is deleted
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Server_Delete.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# How to edit a server
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Server Hosting Experiment](https://docs.cwtch.im/docs/settings/experiments/server-hosting) turned on.
|
||||
|
||||
:::
|
||||
|
||||
1. Go to the server icon
|
||||
2. Select the server you want to edit
|
||||
3. Press the pencil icon
|
||||
4. Change the description/ or enable or disable the server
|
||||
5. Click on save server
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/server_edit.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Servers Introduction
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Server Hosting Experiment](https://docs.cwtch.im/docs/settings/experiments/server-hosting) turned on.
|
||||
|
||||
:::
|
||||
|
||||
Cwtch contact to contact chat is fully peer to peer, which means if one peer is offline, you cannot chat, and there is no mechanism for multiple people to chat.
|
||||
|
||||
To support group chat (and offline delivery) we have created untrusted Cwtch servers which can host messages for a group. The messages are encrypted with the group key, and fetch via ephemeral onions, so the server has no way to know what messages for what groups it might be holding, or who is accessing it.
|
||||
|
||||
Currently running servers in the Cwtch app is only supported on the Desktop version as mobile devices' internet conection and environment is too unstable and unsuitable to running a server.
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# How to share your Server Key Bundle
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Server Hosting Experiment](https://docs.cwtch.im/docs/settings/experiments/server-hosting) turned on.
|
||||
|
||||
:::
|
||||
|
||||
Your server key bundle is the package of data a Cwtch app needs in order to use a server. If you just want to make other Cwtch users aware of your server, you can share this with them. Then they will have the ability to create their own groups on the server.
|
||||
|
||||
1. Go to the server Icon
|
||||
2. Select the server you want
|
||||
3. Use the copy address icon to copy the server keys
|
||||
4. Don’t share the keys with people you don’t trust
|
||||
|
||||
<div width="400">
|
||||
<video playsInline autoPlay muted loop width="400">
|
||||
<source src="/video/Server_Keys.mp4" />
|
||||
</video>
|
||||
</div>
|
||||
|
|
@ -0,0 +1,18 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
|
||||
# How to Unlock a server
|
||||
|
||||
:::caution Experiments Required
|
||||
|
||||
This feature requires [Experiments Enabled](https://docs.cwtch.im/docs/settings/introduction#experiments) and the [Server Hosting Experiment](https://docs.cwtch.im/docs/settings/experiments/server-hosting) turned on.
|
||||
|
||||
:::
|
||||
|
||||
If you protected your server with a password, it will need to be unlocked each time you restart the application.
|
||||
|
||||
1. Go to the server Icon
|
||||
2. Click on the pink unlock icon
|
||||
3. Input the password of your server
|
||||
4. Press Unlock
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Einstellungen",
|
||||
"position": 4,
|
||||
"link": {
|
||||
"type": "generierter Index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Darstellung",
|
||||
"position": 2,
|
||||
"link": {
|
||||
"type": "generierter Index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Sprache wechseln
|
||||
|
||||
[Thanks to the help of volunteers](https://docs.cwtch.im/docs/contribute/translate), the Cwtch app has been translated to many languages.
|
||||
|
||||
To change the language Cwtch uses:
|
||||
|
||||
1. Open Settings
|
||||
2. The top setting is "Language", you can use the drop down to select the language that you wish to use.
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Helles/Dunkles Design und Theme-Aufteilung
|
||||
|
||||
1. Drücke das Einstellungssymbol
|
||||
2. Du kannst ein helles oder dunkles Thema wählen, indem Du den Schalter „Verwende helles Theme“ einschaltest
|
||||
3. Wähle mit dem Dropdown-Menü „Farb-Theme“ ein Theme aus, das Dir gefällt
|
||||
4.
|
||||
1. Cwtch: lila Tönung
|
||||
2. Geist: Graue Tönung
|
||||
3. Meerjungfrau: Türkise und violette Tönung
|
||||
4. Mitternacht: Schwarze und graue Tönung
|
||||
5. Neon 1: lila und rosa Tönung
|
||||
6. Neon 2: lila und türkise Tönung
|
||||
7. Kürbis: lila und orange Tönung
|
||||
8. Hexe: Grüne und rosa Tönung
|
||||
9. Vampir: Violette und rote Tönung
|
||||
|
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Streamer/Presentation Mode
|
||||
|
||||
Streamer/Presentation mode makes the app more visually private. In this mode, Cwtch will not display auxiliary information like cwtch addresses and other sensitive information on the main screens.
|
||||
|
||||
This is useful when taking screenshots or otherwise displaying Cwtch in a more public way.
|
||||
|
||||
1. Drücke das Einstellungssymbol
|
||||
2. Toggle "Streamer Mode" to On
|
||||
3. Check it works by looking at your profile or at your contact list
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# UI Spalten
|
||||
|
||||
1. Drücke das Einstellungssymbol
|
||||
2. Klicke auf einzeln
|
||||
3. Wähle die Konfiguration der Spalten aus, die Du verwenden möchtest
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Verhalten",
|
||||
"position": 3,
|
||||
"link": {
|
||||
"type": "generierter Index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Block Unknown Connections
|
||||
|
||||
By default, Cwtch interprets connections from unknown cwtch addresses sas [Contact Requests](https://docs.cwtch.im/docs/chat/accept-deny-new-conversation). You can change this behaviour through the Block Unknown Connections setting.
|
||||
|
||||
If enabled, Cwtch will auto close all connections from Cwtch addresses that you have not added to your conversation list. This will prevent people who have your cwtch address from contacting you unless you also add them.
|
||||
|
||||
To enable:
|
||||
|
||||
1. Go to Settings
|
||||
2. Toggle on Block Unknown Contacts
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Benachrichtigungsinhalt
|
||||
|
||||
1. Zu den Einstellungen
|
||||
2. Zum Verhalten scrollen
|
||||
3. Der Benachrichtigungsinhalt steuert den Inhalt von Benachrichtigungen
|
||||
1. Einfaches Event: nur "Neue Nachricht"
|
||||
2. Konversationsinformation: "Neue Nachricht von XXXXX"
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Benachrichtigungsrichtlinie
|
||||
|
||||
1. Zu den Einstellungen
|
||||
2. Zum Verhalten scrollen
|
||||
3. Die Benachrichtigungsrichtlinie steuert das Benachrichtigungsverhalten
|
||||
4. Auf Voreinstellung klicken, um das Verhalten zum Einschalten oder Stummschalten aller Benachrichtigungen zu ändern
|
||||
5. Wähle deine bevorzugte Benachrichtigungsrichtlinie
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"label": "Experiments",
|
||||
"position": 4,
|
||||
"link": {
|
||||
"type": "generated-index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,40 @@
|
|||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# Clickable Links Experiment
|
||||
|
||||
:::danger
|
||||
|
||||
This feature, if enabled, presents a **deanonymization** risk.
|
||||
|
||||
Do **not** open URLs from people you do not trust. Links sent via Cwtch are opened via the **default** browser on the system. Most web browsers cannot provide anonymity.
|
||||
|
||||
:::
|
||||
|
||||
# Enable the Clickable Links Experiment
|
||||
|
||||
Clickable links are **not** enabled by default. To allow Cwtch to open links in messages:
|
||||
|
||||
1. Go to Settings
|
||||
2. Enable Experiments
|
||||
3. Enable the `Clickable Links` Experiment
|
||||
|
||||
|
||||
|
||||
## Risks
|
||||
|
||||
Clickable links in messages are a very useful feature however there are risks you should be aware of if you choose to enable this feature.
|
||||
|
||||
To prevent accidental triggering, after clicking on a link in a message, Cwtch will first open an additional prompt with two options:
|
||||
|
||||
|
||||
|
||||
1. Copy the URL to the Clipboard
|
||||
2. Open the URL in the **default web browser**
|
||||
|
||||
You can use the back button on your device, or click away from this prompt to avoid selecting either option.
|
||||
|
||||
**Cwtch cannot protect you if you open malicious links**.
|
||||
|
||||
The URL is opened in the **default web browser** which will likely, at a minimum, expose your IP address to the server hosting the URL. Web pages may also use other browser vulnerabilities to gather additional information, or further exploit your computer.
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# File Sharing
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Enable the Groups Experiment
|
||||
|
||||
1. Go to Settings
|
||||
2. Enable Experiments
|
||||
3. Enable the Group experiment
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Image Previews and Profile Pictures
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
|
||||
# Message Formatting
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Server Hosting
|
||||
|
||||
**Server hosting is currently an experimental feature in Cwtch, it is not enabled by default.**
|
||||
|
||||
1. Go to Settings
|
||||
2. Enable Experiments
|
||||
3. Enable the Server Hosting experiment
|
||||
4. You will probably also want to enable the Group experiment if you want to participate on a group hosted on your server
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# An Introduction to Cwtch App Settings
|
||||
|
||||
## Appearance
|
||||
|
||||
These are settings which effect how cwtch looks, including themes and localization.
|
||||
|
||||
## Behaviour
|
||||
|
||||
These settings impact how cwtch responds to certain events e.g. notifications for new messages, or requests from unknown public addresses.
|
||||
|
||||
## Experiments
|
||||
|
||||
There are many features in Cwtch that people would like to have ut whose implementation requires additional metadata, or risk, beyond the minimum that Cwtch requires for basic operations.
|
||||
|
||||
As such under **Experiments** you will find a number of **optional** settings which, when enables, provide additional features like group chat, file sharing or message formatting.
|
||||
|
||||
You should think carefully when enabling these features about the new risks that might be involved, and if you are comfortable opting-in to those risks. For many the benefits of file sharing, image previews and group chat far outweigh the potential harms - but for other we require everyone to opt-in to these features.
|
||||
|
||||
You can opt-out at any time, all features are implemented locally within the Cwtch app.
|
||||
|
||||
|
|
@ -0,0 +1,37 @@
|
|||
---
|
||||
sidebar_position: 5
|
||||
---
|
||||
|
||||
# Tor
|
||||
|
||||
Cwtch uses [Tor](https://www.torproject.org/) to provide routing and connections. Using Tor hidden services to host profiles and on the fly generated "ephemeral" connections when making a connection provides strong anonymity guarantees to users of Cwtch.
|
||||
|
||||
## Tor Pane
|
||||
|
||||
Since we are adding an additional networking layer to Cwtch, we provide a pane to view Tor network status and make changes. To access it
|
||||
|
||||
1. From the profile list pane, click the Tor icon 
|
||||
2. View the tor network status
|
||||
|
||||
```
|
||||
Tor Status: Online
|
||||
Tor Version: 0.4.6.9
|
||||
```
|
||||
|
||||
### Reset Tor
|
||||
|
||||
The Tor network itself can occasionally have stale connections that aren't detected immediatly by it or Cwtch (we're always trying to improve this). Sometimes a user may find contacts or groups appearing offline they feel should be online. If you'd like to restart all the networking connections in Cwtch, we provide a mechanism to reboot tor from within the app. The **reset** button will reboot Tor from within the Cwtch app.
|
||||
|
||||
|
||||
### Cache Tor Consensus
|
||||
|
||||
By default we start a fresh Tor process every time the app boots, and it requires downloading some Tor network state before it can start. This process is not instant. If you want to speed up Cwtch booting, you can enable Caching Tor Conensus to speed up future boots. If you run into a boot problem where the data is stale or corrupted and Cwtch is reporting it cannot boot Tor, disable this feature and **reset** tor again, and it should work.
|
||||
|
||||
### Advanced Tor Configuration
|
||||
|
||||
We also offer the option to provide advance Tor configuration option in this section by allowing you to
|
||||
|
||||
- Specify a custom SOCKS port to connect to an existing Tor over
|
||||
- Specify a custon Control port to connect to an existing Tor over
|
||||
- and specify further options by entering custom `torrc` options
|
||||
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
{
|
||||
"link.title.Docs": {
|
||||
"message": "Dokumentation",
|
||||
"description": "The title of the footer links column with title=Docs in the footer"
|
||||
},
|
||||
"link.title.Community": {
|
||||
"message": "Gemeinschaft",
|
||||
"description": "The title of the footer links column with title=Community in the footer"
|
||||
},
|
||||
"link.title.More": {
|
||||
"message": "Mehr",
|
||||
"description": "The title of the footer links column with title=More in the footer"
|
||||
},
|
||||
"link.item.label.Tutorial": {
|
||||
"message": "Anleitung",
|
||||
"description": "The label of footer link with label=Tutorial linking to /docs/intro"
|
||||
},
|
||||
"link.item.label.Twitter": {
|
||||
"message": "Twitter",
|
||||
"description": "The label of footer link with label=Twitter linking to https://twitter.com/cwtch_im"
|
||||
},
|
||||
"link.item.label.Home": {
|
||||
"message": "Start",
|
||||
"description": "The label of footer link with label=Home linking to https://cwtch.im"
|
||||
},
|
||||
"link.item.label.Git": {
|
||||
"message": "Git",
|
||||
"description": "The label of footer link with label=Git linking to https://git.openprivacy.ca/cwtch.im"
|
||||
},
|
||||
"copyright": {
|
||||
"message": "Copyright © Open Privacy Research Society",
|
||||
"description": "The footer copyright"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
{
|
||||
"title": {
|
||||
"message": "Cwtch Handbuch",
|
||||
"description": "The title in the navbar"
|
||||
},
|
||||
"item.label.Cwtch Intro": {
|
||||
"message": "Cwtch-Einführung",
|
||||
"description": "Navbar item with label Cwtch Intro"
|
||||
},
|
||||
"item.label.Git": {
|
||||
"message": "Git",
|
||||
"description": "Navbar item with label Git"
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue