From d112321d15ab020f4715e9c37982dd36fae5fc3d Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Fri, 27 Jun 2025 15:04:36 +0000 Subject: [PATCH 01/13] Translate _tella-languages.md in ps [Manual Sync] 4% of minimum 1% translated source file: '_tella-languages.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/_tella-languages.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md new file mode 100644 index 00000000..5468c133 --- /dev/null +++ b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md @@ -0,0 +1,21 @@ +1. Arabic +2. Belarusian +3. Bengali +4. Burmese +5. انګریزې +6. French +7. Indonesian +8. Jingpho +9. Kannada +10. Karen Sgaw +11. Kurdish +12. Malayalam +13. Ndau +14. Persian +15. Portuguese +16. Portuguese (Mozambique) +17. Russian +18. Spanish (Latin America) +19. Tamil +20. Tsonga +21. Vietnamese \ No newline at end of file From f7983bc759d16d987b8cb970b4b99e5036863668 Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Fri, 27 Jun 2025 15:05:12 +0000 Subject: [PATCH 02/13] Translate security-and-privacy.md in ps [Manual Sync] 7% of minimum 1% translated source file: 'security-and-privacy.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../Discover Tella/security-and-privacy.md | 133 ++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md new file mode 100644 index 00000000..eb34ad6a --- /dev/null +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md @@ -0,0 +1,133 @@ +--- +id: security-and-privacy +title: Security and privacy +description: Details about Tella security and privacy. +slug: /security-and-privacy +--- + +# Security and privacy + +Tella was built to protect those who face physical and digital repression, so all of Tella’s features and product decisions are built with privacy and security in mind. Tella is regularly audited by independent security firms, and features and documentation are designed with the support and guidance from security professionals. + + +## Privacy {#privacy} + +We only collect the minimum amount of data that is necessary to fulfill the purpose of Tella. **We never collect personally identifiable information. We never disclose, share, or sell any of your data to third parties**. + +Through using our app, users may send data to servers managed by individuals or organizations they're working with. We encourage users to ask these individuals or organizations about their data privacy policies, as they may differ from ours. We provide the same standard of privacy protection to all our users no matter where you are in the world. + +You can read Tella's full [Privacy Policy](/privacy). + + +### Tella Android {#tella-android} + +Tella Android, as available on the Google Play Store, includes two trackers, [Google CrashLytics](https://firebase.google.com/docs/crashlytics) and [Google Firebase Analytics](https://firebase.google.com/docs/analytics), which help us detect bugs and crashes. This is critical to keep the app secure and performant for at-risk users. + +### Tella-FOSS {#tella-foss} + +[Tella-FOSS](/faq#is-tella-available-on-f-droid), published on the [F-droid store](https://f-droid.org/en/packages/org.hzontal.tellaFOSS/), does not contain any trackers. + + +### Tella iOS {#tella-ios} + +[Tella for iOS](https://apps.apple.com/us/app/tella-document-protect/id1598152580) does not include any trackers. + +As a result of Apple’s strict iOS app policies, Tella for iOS is currently not available on alternative app stores or for manual install. + +## Analytics {#analytics} + +In Tella Android, Tella FOSS and [Tella Web](/tella-web), users can choose to share analytics to improve Tella. This data helps us understand how people use Tella and which features are important to them. ***Analytics data is only collected if users opt-in in the app's settings*** + +We use [Divvi Up](https://divviup.org/), a privacy-respecting telemetry service. Divvi Up is implemented by the [Internet Security Research Group (ISRG)](https://www.abetterinternet.org/), a nonprofit organization that also maintains the [Let’s Encrypt](https://letsencrypt.org/) project. + +Here are some information about our privacy-preserving analytics approach: + +1. **All data is anonymous and aggregated**: the Divvi Up library splits the data into two anonymized and encrypted shares and uploads each share to different data share processors (one hosted by ISRG and one hosted by us) that do not share data with each other. This way, only partial information about the original data is revealed to either processor. +2. **Even if we wanted to, we couldn't get the whole data**: It's not possible to construct the whole data with only one share. Each processor aggregates its data shares into a partial sum. The partial sums can then be combined into a final aggregation, permitting useful statistics over the whole body of data while revealing minimal information about individual participants. Extensive technical documentation about how Divvi Up works can be found [here](https://docs.divviup.org/). +3. **We collect as little data as possible**: Even though all data is anonymized, we always minimize the amount of data we collect. As of the latest versions of Tella, we only collect data about the following events (and nothing more): + + **Tella Android and Tella FOSS** + - Number of times Tella is successfully unlocked. + - Number of media files recorded (videos/photos taken and audio recordings captured). + - Number of files imported from the device's gallery or file system into Tella. + - Number of security features activated (number of times that camouflage is enabled, number of times that the quick delete action is triggered). + - Number of new installations. + - Number of reports uploaded to any connection (Tella Web, Uwazi, ODK, Nexcloud, Google Drive, Dropbox) + - Time spend in Tella. + + + **Tella Web** + The data below is only collected from Tella Web instances that have opted-in to share privacy-preserving analytics with the Tella team. + - Number of visits (triggered every time someone enters any Tella Web instance). + - Number of file uploads (triggered every time someone uploads a file to any Tella Web instance). + - Number of Report uploads (triggers every time someone uploads a report to any Tella Web instance). + + + For more information about the metrics we add to our apps, check out our [release notes](/releases). + + +## Security features {#security-features} + +Tella integrates various security measures in place to achieve an acceptable level of security: + + + +1. **Encryption at rest**: All data is encrypted at rest, on the user's device. This means that unless the app is unlocked (by entering the user's lock), the data it contains cannot be accessed at all. Even if someone seizes the phone and extracts all the data using a computer, the data will remain unreadable. +2. **Encryption in transit:** All data being transferred between Tella and servers (see [Connections section](/features#connecting-to-servers)) is encrypted through[Transport Layer Security (TLS)](https://en.wikipedia.org/wiki/Transport_Layer_Security). Tella makes it impossible to send data to a server without TLS encryption. +3. **Lock**: Tella users [choose a lock](/features#app-lock) for the app as soon as they install it. Password, Pattern and PIN locks are available and each level of security is communicated to the users. +4. **Lock timeout:** Users can also configure a [lock timeout](/features#lock-timeout-configuration), to choose how quick Tella will lock when not in use. By default, the lock timeout is set to ‘immediately’, so as soon as the user exits Tella, the app locks and all of the data is encrypted. +5. **Camouflage**: On Tella Android, there are currently [two camouflage](features#camouflage) modes for Tella: a fully functional calculator and the possibility to change the app name and icon to make it harder to find on the phone. Due to iOS restrictions, it is not possible to camouflage Tella for iOS. +6. **Quick Delete button**: Users can enable a **[quick delete](features#quick-delete)** sliding button to quickly wipe data from Tella in an emergency situation. Users can choose, in the Tella settings, to delete all the files stored in Tella, draft and submitted forms, server settings and the app itself when that button is triggered. When the Quick Delete button is triggered, a 5-second countdown is displayed to the user. During the countdown, the user can cancel the Quick Delete action by tapping anywhere on the screen. When the countdown reaches 0, the delete action set by the user is applied. If the user had selected the ‘delete Tella’ options, Android will ask them to confirm the app’s deletion. +7. **Camera silent mode**: Users can choose to [turn off the camera shutter sound](/features#camera-silent-mode) to draw less attention when taking photos. +8. **Screen security**: By default, Tella blocks screenshots and screen recordings inside Tella and hides the screen preview in the list of recent apps. [This setting](/features#screen-security) can be disabled, for example to record tutorials inside Tella or mirror the app to a computer for a presentation. +9. **Restrict unlocking attempts**: Users can decide how many failed [unlock attempts](features#restrict-unlocking-attempts) are allowed before everything inside Tella is deleted and whether a visual indicator with the remaining unlocking attempts will be visible on the unlock screen or not. + +:::tip Video tutorial 🎥 +Learn more about Security Features in our [video tutorial](/video-tutorials#additional-security-features) +::: + + +## Security limitations {#security-limitations} + +There is no such thing as an app that is 100% "secure". Security is dependent on the threats and risks faced by each user, and the capabilities of adversaries. With Tella, we did our best to add as many layers of security as possible to reduce the likelihood that someone can detect the app or access its data. Here, we list all the important security risks and limitations users should be aware of when using Tella: + + + +* Camouflage: + * On Android, when Tella is camouflaged using one of the two [camouflaging methods available](/features#camouflage), the app can still be detected in the Android Settings. This means that someone who navigates to the Android settings > Apps will be able to see that there is an app installed on the device that is called “Tella”. They will also be able to see the size of the app. So if the user stores very large files, like videos, the app may raise attention. +* File management: + * Files that are exported out of Tella to the device file system are no longer encrypted. This means that anyone with access to the device who browses the file system or gallery may be able to find those files. + * Files that are shared through third-party apps may be visible to those apps and saved unencrypted on the device’s file system, and someone searching these apps may be able to find the files. For example: a photo stored inside Tella and shared on WhatsApp will be visible inside WhatsApp, and will also be visible in the file system, where WhatsApp photos are stored. This happens because in order to share with third-party apps the file needs to be saved on the phone file system, which is not encrypted. This is why we recommend manually deleting the file from the device’s file system after sharing it. + * Importing a file creates a copy of this file, and then imports and encrypts it into Tella. On version 1.1(iOS) and 2.1(Android) we developed a feature for users to select if they want to keep or delete the original file when importing to Tella. However, we recomend to verify the original file is not present on the Trash bin (My files > Trash) and to delete the file from any automatic backup services you have enabled on your phone (Google Photos, Dropbox, etc). + + +## Security audits {#security-audits} + +We regularly ask independent security firms to audit our code to ensure it is robust and secure. + +| نېټه | Audited by | Platforms audited | Link | +| -----|----------|----|-----------| +| August 2024 | Radically Open Security | Android, iOS, Android FOSS|[View pen-testing results]()| +| May 2024 | Subgraph Technologies, Inc. | Android, iOS, Tella Web|[View updated report confirming fixes has been implemented]()| +| May 2023 | Subgraph Technologies, Inc. | Android, iOS, Tella Web |[View security audit]()| + + +This is the summary from the latest audit and the status of the vulnerabilities identified: + +| عنوان | شدت | Platform | وضعیت | +|-----------------------------------------------------|-------------|-------------|-------------| +| Require re-authentication for changing key security settings | Moderate | ټوليز | Planning | +| Improve webview implementation | Moderate | iOS | Resolved | +| Improve GitHub practices (merging to main and tags) | ټیټ | Android, Android FOSS | Resolved (pending re-test) | +| Increase PBKDF2 iteration counts. | ټیټ | Android, Android FOSS | Soon | +| Do not allow clear-text traffic in Android manifest.| ټیټ | Android, Android FOSS | Resolved | +| Outdated 3rd-party dependencies | Unknown | Android, Android FOSS | Resolved | + + + + + + + + + From e5f50b5d51d66916d6d7cac22e39956e3179733a Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Fri, 27 Jun 2025 15:05:29 +0000 Subject: [PATCH 03/13] Translate odk.md in ps [Manual Sync] 11% of minimum 1% translated source file: 'odk.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/For organizations/odk.md | 134 ++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 i18n/ps/docusaurus-plugin-content-docs/current/For organizations/odk.md diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/For organizations/odk.md b/i18n/ps/docusaurus-plugin-content-docs/current/For organizations/odk.md new file mode 100644 index 00000000..79c826ec --- /dev/null +++ b/i18n/ps/docusaurus-plugin-content-docs/current/For organizations/odk.md @@ -0,0 +1,134 @@ +--- +id: odk +title: Open Data Kit (ODK) +description: The Open Data Kit server connection is available for organizations looking to collect structured data using forms. +slug: /odk +--- + +# Open Data Kit (ODK) Connection + +The [Open Data Kit (ODK)](https://getodk.org/) is an open standard used to create custom forms and collect data. + +An Open Data Kit server allows organizations to aggregate, in a central repository, data collected by their members or partners. Tella users connect to their organization's ODK instance, fill forms as many times as they need (even if they don't have internet connectivity), and upload the data. Organizations can download the data from the server or analyze it on the server, depending on the chosen server alternatives. + +Similarly to any other server connection (like [Tella Web](/tella-web), [Google Drive](/g-drive), [Dropbox](/dropbox), [Nextcloud](/nextcloud) or [Uwazi](/uwazi)), connecting to the ODK server enhances the security of data collected on Tella by: + +1. Allowing users to collect data directly inside Tella's encrypted container. +2. Ensuring that data is sent directly from Tella to the ODK server, without relying on a third-party tool or app. +3. Allowing users to back up their data on a remote server, to lower the risk that data is discovered on their mobile device. +4. Ensuring that organizations can preserve important information even in the event of device seizure or destruction, and can organize it for research, advocacy, or accountability processes. + +### Choosing and Installing Your ODK Server {#choosing-and-installing-your-odk-server} + +Because ODK is an open standard, Tella can be used with any of the tools that are ODK-compliant. + +For civil society organizations and human rights defenders, we recommend using [KoboToolbox](https://www.kobotoolbox.org/) to create forms with custom questions, manage users, and aggregate the data submitted by users. Based on our experience, KoboToolbox is user-friendly and flexible, and it is also open source. KoboToolbox offers a [community plan for non-profits](https://www.kobotoolbox.org/pricing/) and offer free training resources and guidance on how to structure the data on the server (Self-serve learning base and Community Forum). It is also possible [to use a private instance of KoboToolbox](https://www.kobotoolbox.org/services/private-servers/) or [self-host it](https://support.kobotoolbox.org/kobo_your_servers.html). + +:::tip +We are work closely with the Kobotoolbox team. If you are interested in using the Tella-KoboToolbox connection and would like some support or to discuss the best hosting plan for your use case, please [contact us](/contact-us). +::: + +There are other ODK-compliant apps available, like [Ona](https://ona.io/home/) or [ODK Cloud](https://https://getodk.org/index.html). Tella works with any of these. + + +### When to Use ODK {#when-to-use-odk} + +We recommend ODK to organizations that need on-the-ground users to collect data in a structured manner like forms. We also recommend it to organizations that don't have the technical capacity to install and maintain a server and want to use a ready-to-use cloud instance. If you use a cloud instance, remember that the organization hosting your ODK instance will be able to access your data. This is an important consideration when deciding whether to self-host or use a cloud service. + +ODK and KoboToolbox are widely used, well-documented, and easy to use. There are guides available, and they offer support to non-profit organizations on how to structure and maintain their data. + +:::tip +If you need help figuring out if ODK is best for your use-case, [read our guide](/for-organizations) or [contact us](/contact-us)! +::: + +## Model Your Data {#model-your-data} + +KoboToolbox offers a detailed guide on how to create your project and add questions to your forms, and how to deploy them to make them available to on-the-ground users [here](https://support.kobotoolbox.org/overview_of_creating_a_project.html). + +## Connect Tella to an ODK Instance to Collect Data {#connect-tella-to-an-odk-instance-to-collect-data} + +In this documentation, we focus on how to collect data using Tella. There are alternative mobile apps that can be used to collect data on ODK, including the ODK Collect Android app. You can see a comparison of these alternatives [here](/faq#how-is-tella-different-from-other-documentation-apps). + +:::info +The ODK connection is not available for Tella iOS. +::: + +### Connect to an ODK Server {#connect-to-an-odk-server} +After creating and deploying a Form using any ODK-compliant server, in Tella, go to **Settings** > **Connections** > **+** > **Open Data Kit (ODK)**. Fill the following fields: +- **Server Name**: A descriptive name for your server in Tella. The name you select is only visible in the app and does not impact the ODK connection. +- **Server URL**: Your server URL. For example, `kc.kobotoolbox.org` if you are using the KoboToolbox public server. +If your server requires user authentication, tap the **Advanced** button and enter your **Username** and **Password**. Your server's administrator should provide all this information to you. + + +### Fill forms {#fill-forms} + +After you successfully connected to the ODK instance, you'll see a new card called "Forms" in the **Connections** sections of the Tella homescreen. + +After you enter the **Forms** section, you will see a list of Forms available to you on the instance(s) that you are connected to. Using the **Download** button you can download forms to Tella so that you can fill them, even if you are not connected to the internet. + +You can tap on each blank form to start filling it. + + +#### Submit forms {#submit-forms} + +As you collect data and fill forms the following options are available to increase offline support on Tella: +- Submit: send the filled form to the ODK server. +- Save as draft: save a form that is not completed so you can continue working on it later. +- Submit later: mark a form as complete to submit it a later point. Until it is sent, it will be available in the Outbox tab. +- Drafts tab: a tab with the list of all draft forms. Drafts can be edited or deleted. +- Outbox tab: a table with the list of all forms ready to be submitted. Forms in the Outbox tab can be edited, deleted, or submitted. +- Submitted tab: a tab with the list of all forms that have been successfully sent to the server. Submitted forms can be deleted. +- Pause/Resume submission: you can manually pause a submission and resume it when ready. +- Automatically pause submission when offline: forms will be sent to the Outbox tab if the submission fails due to connectivity issues. + +### Supported Question Types {#supported-question-types} +Below is an overview of the ODK question types that are supported in Tella Android. If there is a question type that isn't supported in Tella and that is critical to your workflow, please [contact us](/contact-us). + +| **Question type** | **Tella Android** | +|------|------| +| Select One | ✔️ | +| Select Many | ✔️ | +| متن | ✔️ | +| Number / Decimal | ✔️ | +| نېټه | ✔️ | +| Time | ✔️ | +| Date & time | نه | +| Point (calculate my current location) | ✔️ | +| Point (show my location on a map) | ✔️ | +| Point (let me choose my location on a map) | ✔️ | +| Line | نه | +| Area | نه | +| Photo | ✔️ | +| Photo signature (handwrite my signature) | ✔️ | +| اډیو | ✔️ | +| ویډیو | ✔️ | +| فایل | ✔️ | +| Note | ✔️ | +| Barcode / QR Code | نه | +| Acknowledge | ✔️ | +| Rating | ✔️ | +| Question Matrix | نه | +| Ranking | ✔️ | +| Calculate | نه | +| پټ شوي | نه | +| Range | نه | +| External XML | نه | + +### Supported Features {#supported-features} + +Below is an overview of the ODK features that are supported in Tella Android. If there is a feature that isn't supported in Tella and that is critical to your workflow, please [contact us](/contact-us). + +| **Feature** | **Tella Android** | +|------|------| +| [Offline data collection](/odk#submit-forms) | ✔️ | +| [Form logic](https://docs.getodk.org/form-logic/) | ❌ | +| [Requiring responses](https://docs.getodk.org/form-logic/#requiring-responses) | ✔️ | +| [Setting default responses](https://docs.getodk.org/form-logic/#setting-default-responses) | ❌ | +| [Triggering calculations on value change](https://docs.getodk.org/form-logic/#triggering-calculations-on-value-change) | ❌ | +| [Validating and restricting responses](https://docs.getodk.org/form-logic/#validating-and-restricting-responses) | ❌ | +| [Conditionally showing questions](https://docs.getodk.org/form-logic/#conditionally-showing-questions) | ✔️ | +| [Groups of questions](https://docs.getodk.org/form-logic/#groups-of-questions) | ✔️ | +| [Repeating questions](https://docs.getodk.org/form-logic/#repeating-questions) | ✔️ | +| [Filtering options in select questions](https://docs.getodk.org/form-logic/#filtering-options-in-select-questions) | ✔️ | +| [Generating select ones from repeats](https://docs.getodk.org/form-logic/#generating-select-ones-from-repeats) | ❌ | +| [Form metadata (background data collection)](https://docs.getodk.org/form-audit-log/) | ❌ | From 93946c9c75b2db6aea4b1b123ae3f21bb3d94b9b Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Fri, 27 Jun 2025 15:05:53 +0000 Subject: [PATCH 04/13] Translate features.md in ps [Manual Sync] 3% of minimum 1% translated source file: 'features.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/Discover Tella/features.md | 389 ++++++++++++++++++ 1 file changed, 389 insertions(+) create mode 100644 i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md new file mode 100644 index 00000000..457f3b10 --- /dev/null +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md @@ -0,0 +1,389 @@ +--- +id: features +title: Tella features +description: A detailed description of Tella features. +slug: /features +--- + +import FeaturesTable from '.././_features-table.md'; +import ConnectionsTable from '.././_connections-table.md'; + +# Tella features + +All of the following features are available to all users as soon as they download Tella. They do not require any connection to a server or any special set up. + + + + +## App lock {#app-lock} + +When installing Tella, the user has to select a lock 🔒 to encrypt and decrypt the content of the app. + + +* On Android, the user can select a pattern, PIN, or password. +* On iOS, the user can select a PIN or password. + +Without this lock, it is not possible to open Tella. + +:::danger +If the user loses their lock, it is not possible to regain access to Tella and the files stored inside the app. The user has to uninstall and reinstall Tella, and all files will be lost. 🔒🔑🚪 +::: + +:::tip Video tutorial 🎥 +Learn more about Tella Locks in our [video tutorial](/video-tutorials#tella-locks) +::: + +## Background encryption {#background-encryption} + +Tella [encrypts](#encryption) files in the background so that users can continue performing actions (take more photos or videos, import more files, etc) while files are being encrypted. Users can see ongoing activities that are taking place in the background in a **Background activity tray** that's accessible from the Tella homescreen, by tapping on the "notifications" icon (🔔) on the top left. + +While files are being encrypted, Tella displays an orange marker on the notifications icon. If the user opens the background activity tray while some files are being encrypted, they will see the list of files in the queue and the encryption progress. + +:::danger +If the user hard exit Tella (for example by using [Quick Exit](#quick-exit) or minimizing the app) while files are being encrypted in the background, those will be lost. +::: + +:::info +If [verification mode](/features#verification-mode) is turned on, background encryption is automatically disabled to make sure that all file metadata is captured at the same time as the photo, video, or audio file is saved. +::: + +## Backup files to a cloud {#backup-files} +We are in the process of adding options for individuals and organizations to backup their data to different clouds. Backups, for the moment, need to be made manually, by creating reports (using, for example, the date of "today" as the report title) and submitting them to the connected server. Files will be available on the connected server inside a folder with the report title. + +For the moment we support the following connections. Follow each of the links to find details and step-by-step guides on how to connect and use each of them: +* [Open Data Kit (ODK)](/odk) +* [Uwazi](/uwazi) +* [Tella Web](/tella-web) +* [Google Drive](/g-drive) +* [Nextcloud](/nextcloud) +* [Dropbox](/dropbox) + +On this table we explain what server types are available on the Tella apps: +. + + +:::danger +For the moment, the submission to any type of server it is **not** encrypted. People who have access to the server itself are able to see the files. +::: + + + +## Lock timeout configuration {#lock-timeout-configuration} + +By default Tella will lock immediately every time the user exits the app or your phone’s screen turns off. If you’d like to change this setting, the user can do so by going to + +Settings ⚙️ > Security > Lock Timeout. + +The available options are 1 minute, 5 minutes, 30 minutes and 1 hour. ⏱️ + +:::info +Please use this feature carefully as if Tella is unlocked the data would be unprotected and anyone who enters Tella will be able to see all information there. +::: + +:::info +When the camera or the audio recorder are open, Tella won’t lock +::: + +:::tip Video tutorial 🎥 +Learn more about Tella Additional Security Features in our [video tutorial](/video-tutorials#additional-security-features) +::: + + + +## Camera silent mode {#camera-silent-mode} + +By default Tella has camera silent mode disabled. By going to **Settings ⚙️** > **Security** > **Camera silent mode**, it is possible to turn off the camera shutter sound to draw less attention when taking photos. 📷🔇 + +:::tip Video tutorial 🎥 +Learn more about Tella Additional Security Features in our [video tutorial](/video-tutorials#additional-security-features) +::: + + +## Screen security {#screen-security} + +By default Tella blocks screenshots, screen recordings inside Tella and hides the screen preview in the list of recent apps 📱🔒. It is possible to disable this security feature if the users need to take screenshots or screen recordings, or to mirror Tella to a computer for a presentation, by going to **Settings** ⚙️ > **Security** > **Screen security**. + +On iOS screen security only blocks screen recordings inside Tella and blocks the screen in the list of recent apps, but it’s not possible to disable screenshots or screen recordings. + + +:::tip video tutorial 🎥 +Learn more about Tella Additional Security Features in our [video tutorial](/video-tutorials#additional-security-features) +::: + +## Restrict unlocking attempts {#restrict-unlocking-attempts} +By going to **Settings ⚙️** > **Security** > **Delete after Failed Unlock**, the user can decide how many failed unlock attempts are allowed before everything inside Tella is deleted. + +By default, this setting is Off, which means unlock attempts are not restricted and data won't be deleted. The user can choose to restrict unlocking attempts to 5, 10, or 20. If they choose any of these options, they can also select whether to display a visual indicator on the unlock screen 3 attempts before the specified number (3 attempts remaining, 2 attempts remaining, etc.), or to show no visual indicator at all. + +After the specified number of failed attempts, all files, connections, and everything in Tella get deleted, and the user will go back to the "freshly installed" app state. + +:::info +The Restrict unlocking attempts feature cannot be enabled if Calculator camouflage is enabled. +::: + +:::danger +While this security setting prevents brute force unlocking attempts to enter Tella, it should be used with caution, as there is no way to restore the content of Tella once the maximum number of failed unlocking attempts is reached. +::: + +## Edit Media {#edit-media} +We are in the process of adding the ability to edit media files directly within Tella's encrypted container, so users don't longer need to export their files outside Tella for editing those. + +| **Media Type** | **Feature** | **Tella Android** | **Tella iOS** | **Tella FOSS** | +|----------------|-------------|-------------------|---------------|----------------| +| انځور | Crop | ✔️ | ✔️ | ✔️ | +| انځور | Rotate | ✔️ | ✔️ | ✔️ | +| انځور | Flip | ✔️ | Not yet | ✔️ | +| انځور | Auto-zoom | ✔️ | Not yet | ✔️ | +| ویډیو | Trim | Not yet | ✔️ | Not yet | +| ویډیو | Rotate | Not yet | ✔️ | Not yet | +| اډیو | Trim | Not yet | ✔️ | Not yet | + +Users can edit a picture by going to **More** > **Edit** from the **Images** folder or by tapping the **Edit** button on the top right while viewing image you have on Tella. +- **Rotate**: Use the Rotate button at the bottom of the screen to rotate the image counter-clock wise. +- **Crop**: Drap the corners of the white canvas to crop the picture. +- **Auto-zoom**: The image will automatically zoom in and out depending on the selected canvas, to avoid loosing image quality. +- **Flip**: Use the flip buttons to mirror the image horizontally or vertically. + +When edits are done, users can press the orange check on the top right of the edit screen. The edited file will be saved as a copy of the original file in the same folder. + + +Users can edit videos or audio recordings: +- In any folder, next to the file to be edited, by tapping on **⁝** > **Edit**. +- While listening to an audio recording or watching a video in Tella, by tapping the **Edit** button in the top right corner. + +Current editing options include: +- **Trim**: Move the vertical orange lines to select the new start and end point of your audio or video. +- **Rotate**: Use the Rotate button on the top right of the screen to rotate the video counter-clock wise. + +Use the Play button at the bottom of the screen to listen to the audio or the Cancel button to start over. When you are done editing the file, use the orange scissors ✂️ icon in the top-right corner to save the trimmed audio or video. The edited file will be saved as a copy of the original file in the same folder. + + +## Encryption {#encryption} + +All files stored inside Tella are encrypted. Without the app lock, it is impossible to decrypt and access any of the files stored in Tella. 🔒🔐 + +Upon installing the app, the user decides which lock method they would like to use. For Android, the user can use a six-point pattern, a PIN, or a password. For iOS, they can use a PIN or a password. The app cannot be opened without the lock. + +Even if the device is plugged into a computer and all the device's data is extracted to be analyzed, all Tella content and data will look like gibberish and will be useless. Unlocking the app by entering the correct lock is the only way to decrypt, and therefore read, the content stored in Tella. + +:::danger +If the user’s lock is too weak, an adversary may be able to guess it and open the app on the phone; or the data could be extracted and a computer could brute-force the encryption key and decrypt the data. +::: + +:::danger +If the user forgets their lock, there is no way of gaining access to the app and retrieving its content +::: + +:::tip video tutorial 🎥 +Learn more about Locks and Encryption in our [video tutorial](/video-tutorials#tella-locks) +::: + +:::info +Technnical details about encryption can be found on the [Security and Privacy](/security-and-privacy) section. +::: + +## File management {#file-management} + +Tella allows users to manage files and folders in a similar way they would do on a computer. All files and folders are **encrypted and only accessible within Tella**. 📂📝 + +In Tella, users can: + +* Store any file, including photos 📷, videos 🎥, audio files 🎧, and documents 📝. +* In the All Files folder: + - Create folders and subfolders. + - Move files into folders and from one folder to another. +* Export files to their device. Once saved on their device outside of Tella, files are no longer encrypted and can be accessed by anyone searching the device. +* Import files from their device. Files are automatically encrypted when imported into Tella. + +:::danger +Importing files from the device file system into Tella makes a copy of the files into Tella. Tella will ask if you want to keep or delete the original file from your phone when importing. If you choose to keep the original file, they will be present on the device, outside of Tella and unencrypted. 🔒 +::: + +## Feedback {#feedback} + +There are several options for Tella users to [contact the Tella team](/contact-us) in order to suggest improvements, report bugs and issues and request support. Inside Tella there are 2 alternatives: + +1. **Email:** + - Navigate to **Settings** > **About and Help** > **Contact us** to find the email address. + - Users can email the Tella team using their preferred email app. + +2. **In-App Feedback Form:** + - Go to **Settings** > **Feedback** to enable an in-app feedback form. + - This allows users to share feedback with the Tella team anonymously. + + +To ensure user privacy and anonymity, only essential data is transmitted to our Feedback server through HTTPS POST requests. Logs containing user information (IP address, date and time, and user-agent) are automatically deleted weekly. + +On the Feedback server database, we only store a copy of the text sent by users in the feedback form and which platform it came from (Android or iOS). + + +:::info +The only information that we will receive is the content that users specifially add on the feedback form. If users are requesting support or want us to follow up with them, they should provide a secure way for us to contact them. +::: + + +## Import files from device {#import-files-from-device} + +The user can import files into Tella to keep them secured by using the import feature. They can import files by going to the **Add ( + )** button on either All files, Images, Video, Audio or Documents depending on the type of file they wish to import and then **Import from device** 📥. A prompt will appear asking the user if they would like to keep or delete the original file from their phone memory. The imported files will be kept secured at Tella. + + +:::tip video tutorial 🎥 +Learn more about [Collecting Evidence](video-tutorials#collecting-evidence) and [Sharing data](/video-tutorials#sharing-data-with-other-apps) in our video tutorials. +::: + +## Preserve metadata when importing {#preserve-metadata-when-importing} + +On **Settings** > **Security** users have the option to Preserve or delete the file's metadata when importing Photos and Videos to Tella. EXIF metadata of files migth include data about when the file was created, camera settings or location of the device. + +## Privacy preserving analytics (opt-in) {#privacy-preserving-analytics} +Android users can opt-in to share analytics to improve Tella. All information is anonymous, agregated and can never be linked to individual usres. For technical information about what system do we use and what metrics to we collect, visit the [Analytics section of the Security and Privacy page](/security-and-privacy#analytics). + +## Open files in Tella {#open-files-in-tella} +Images, videos, PDFs and audios can be visualized inside Tella. 📱📄 + +## Camouflage {#camouflage} + +On Tella Android, it is possible to camouflage Tella in two ways: + +1. Users can change the name and icon of the app, to make it look like another app like a game or weather app. 🎮🌦️ +2. Users can hide Tella behind a fully functional calculator. In order to open Tella, the user must input their PIN into the calculator followed by **=** . The Calculator camouflage is only possible if the user uses a PIN lock. It is not possible to camouflage Tella as a Calculator if pattern or password is used. 🔢🔒 + +At this time, due to restrictions on the Apple App Store, Tella for iOS does not support the camouflaging features that are available on Tella Android. + +:::danger +The name "Tella" and its icon will remain visible in the Android settings. This means that camouflage will not protect against an individual _actively_ looking for Tella on the phone or conducting an in-depth analysis of the device. 🔒👀 +::: + +:::info +The Calculator camouflage feature cannot be enabled if the Restrict unlock attempts feature is on. +::: + +:::tip video tutorial 🎥 +Learn more about [Camouflaging Tella](/video-tutorials#camouflaging-tella) in our video tutorial. +::: + + +## Homescreen customization {#homescreen-customization} + +By default Tella's home screen organizes files by type: 📷 images, 🎥 videos, 🎧 audio, 📄 documents, and other files. It also provides an All files section where all files can be accessed. For more information see File Management section. + +For convenience and ease of access, it is also possible to customize the home screen to also show shortcuts to one or more of the following: + +* Recent files, to quickly open the newest files in Tella 💼 +* Favorite forms, for users connected to an ODK server 📝 +* Favorite templates, for users connected to an Uwazi server 📋 + +This configuration can be found in **Settings** > **General**. + + +## Quick delete {#quick-delete} + +A Quick Delete button allows users, in just a few seconds, to delete sensitive data within Tella. Quick delete can be configured on **Settings** > **Security** > **Quick delete**, where the user can choose to enable a sliding button on the home screen to quickly delete information from Tella in emergency situations. If enabled, the user can choose exactly what gets deleted when the feature is used. The available options are: + +* Delete files: Deletes all files stored in Tella 🗑️ +* Delete draft and submitted forms: Deletes drafts and submitted forms in all Connections. [Visit the For Organizations page](/for-organizations) to discover the available server connections 📝 +* Delete server settings: Deletes all server connections and all the forms, templates or reports associated with them 📋 +* Delete Tella: Deletes the app and all the data it contains. It triggers a message asking if the user wants to uninstall Tella as well ❌. + +:::info Delete Tella +The Delete Tella option might not be available on some Android phones due to technical limitations. We are working on a fix for this issue. For iOS it is not possible to programmatically delete an app. +::: + +## Quick exit {#quick-exit} + +By clicking the exit button on Tella’s home screen right top corner, Android users can quickly close and lock the app in case of emergency. While having the lock timeout set to “immediately” means that the app already locks when the user exits, using the Quick Exit button adds an extra layer of security and assurance that the app will be fully closed and locked 🔒 + +On iOS, it is not possible to shut down an app from inside the app itself. Tapping the quick exit button instead locks the app. + +## Verification mode {#verification-mode} + +In the Tella settings, users can activate "Verification Mode" ✅ + +When activated, every time a user takes a photo or a video, or records audio, Tella automatically captures verification information (file metadata). This verification information can be used to corroborate evidence, cross-check with other facts known about the event or about the area where it was captured. The verification information will be included as a separated file when saving the file to the device or when sharing it through third-party apps. The file format is .CSV with the metadata information included in columns. This file can be open with any spreadsheets app (like Excel, Google Spreadsheets, or OpenOffice). + +:::info Contact us +If you need help to better understand Verification Mode, feel free to contact us 😊 +::: + +Below is a list of each piece of metadata captured by Tella: + +**Information about the file** + +* File path: where the file was located in the Tella directory 📂 +* File hash: a unique number to identify the file 🔍 +* File modified: the date and time the file was last modified on the device 📅 + +**Information about the device** + +* Manufacturer: the name of the device manufacturer 📱 +* Hardware: the exact model of the device 💻 +* Device ID: a unique number identifying the Android device 🆔 +* Screen size: the exact screen size of the device 📏 +* Language: the language the device's operating system is set to 🌐 +* Locale: the geographic region the device is set to 🌍 +* Connection status: whether the device is connected or disconnected to the internet 📶 +* Network type: if the device is connected to the internet, specifies whether it is to a WiFi network or to a cellular network 📲 +* Wi-Fi MAC: a unique identifier to the device's Wi-Fi connector 🔍 +* IPv4: a unique address identifying the device's internet connection 🔗 +* IPv6: a more recent identifier to a device's internet connection 🔗 + +**Information about the environment where the file was captured** + +* Location: the exact location of the device, include latitude and longitude coordinates, altitude in meters, the accuracy of the measurement in meters, and the time 🌍 +* Location provider: how device location is determined 📍 +* Location speed: the speed at which the device is traveling 🚀 +* Cell info: the identifying numbers of all the cell towers the device is connected to 📡 +* WiFi info: the name of all WiFi networks in the vincinity of the device 🔍 + +## Connecting to servers {#connecting-to-servers} + +Users can collect data directly in Tella, keep the data protected within the app, and connect to a server to securely send the data to a server. This feature is frequently used by organizations who centralize the data collected by volunteers or activist on the ground. These people collect information using Tella on their phones and then send it to their organizations. Previous Tella deployments where on-the-ground users collect data and send it to an organization's server have ranged from 1 to 2,000 users. 📲 📡 + +Currently the servers that can be connected to Tella are: + +* [Open Data Kit (ODK)](/odk) +* [Uwazi](/uwazi) +* [Tella Web](/tella-web) +* [Google Drive](/g-drive) +* [Nextcloud](/nextcloud) +* [Dropbox](/dropbox) + + +:::tip Video tutorial 🎥 +Learn more about [Connecting to Servers](/video-tutorials#server-connections) in our video tutorials. +::: + + +## Camera (photos and videos) {#camera-photos-and-videos} + +Tella offers a built-in camera where you can take photos and videos. All media collected inside Tella will not be available outside of it, as all files get encrypted as soon as they are taken. Files can only be accessed inside Tella, using the lock to open the app. Photos and videos won’t appear on the phone Gallery. In Tella, photos and videos will have a default name, but users can rename those using the Rename button. Files can also be organized in folders. 📷 + +The camera offers the possibility to change the resolution of videos before recording in order to save space: the lower the resolution, the less space the video takes, but also the lower the quality of the video. 🎥 💾 + +In [Tella-FOSS](/faq#is-tella-available-on-f-droid), where we use the fully open-source CameraX library, some of the Camera’s features (zoom, flip camera, enable flash, enable grid, change video resolution) are missing. + + +## Select video resolution {#select-video-resolution} +You can easily choose your desired video resolution on Tella by accessing the video recording screen and tapping on the Settings button. The available options include: +- Highest possible resolution +- High resolution (1080p) +- Medium resolution (720p) +- Low resolution (480p) + +Video resolution refers to the number of pixels in each frame of the video. Higher resolutions, such as 1080p or 720p, result in sharper and more detailed videos. However, keep in mind that higher resolution videos also have larger file sizes, which may require more storage space on your device. + +It's important to note that selecting video resolution is currently only supported on Android devices. + + +## Audio Recorder {#audio-recorder} + +Tella has a built-in audio recorder. All audio recorded inside Tella will not be available outside of it, as all files get encrypted as soon as they are taken. Audio files can only be accessed inside Tella, using the lock to open the app. Recordings will not appear on the phone’s Voice Recording app or file system. In Tella, audio files will have a default name, but users can rename those using the Rename button. Audio recordings can also be organized in folders. 🎤 🎧 + +The audio recorder allows users to pause the recording and restart it as needed, keeping all the information on the same file. Users see how much space they have available while recording, to ensure they will not be out of space while recording. 📈 💾 + + +## Offline data collection {#offline-data-collection} + +Once Tella is installed and configured on the phone, it doesn't need an internet connection to collect data. 📲 An internet connection is only needed to share files through other apps or through Connections. 🌐 If users have a server connected, once the forms or templates are downloaded to the phone, all data collected will be stored on the outbox tab and they can upload it to the server once they connect to the internet. 📩 + + From dbbc5be6ead62941e0b15f338f6ac430e9d808ad Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Mon, 1 Dec 2025 16:10:24 +0000 Subject: [PATCH 05/13] Translate _tella-languages.md in ps [Manual Sync] 4% of minimum 1% translated source file: '_tella-languages.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/_tella-languages.md | 42 ++++++++++--------- 1 file changed, 22 insertions(+), 20 deletions(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md index 5468c133..d1a7cd0d 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md @@ -1,21 +1,23 @@ 1. Arabic -2. Belarusian -3. Bengali -4. Burmese -5. انګریزې -6. French -7. Indonesian -8. Jingpho -9. Kannada -10. Karen Sgaw -11. Kurdish -12. Malayalam -13. Ndau -14. Persian -15. Portuguese -16. Portuguese (Mozambique) -17. Russian -18. Spanish (Latin America) -19. Tamil -20. Tsonga -21. Vietnamese \ No newline at end of file +2. Azerbaijani +3. Belarusian +4. Bengali +5. Burmese +6. Chinese +7. انګریزې +8. French +9. Indonesian +10. Jingpho +11. Kannada +12. Karen Sgaw +13. Kurdish +14. Malayalam +15. Ndau +16. Persian +17. Portuguese +18. Portuguese (Mozambique) +19. Russian +20. Spanish (Latin America) +21. Tamil +22. Tsonga +23. Vietnamese \ No newline at end of file From bd74048dc933083cce7adc437692e91da7514d34 Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Mon, 1 Dec 2025 16:11:03 +0000 Subject: [PATCH 06/13] Translate features.md in ps [Manual Sync] 3% of minimum 1% translated source file: 'features.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/Discover Tella/features.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md index 457f3b10..13a8284e 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md @@ -280,13 +280,12 @@ This configuration can be found in **Settings** > **General**. A Quick Delete button allows users, in just a few seconds, to delete sensitive data within Tella. Quick delete can be configured on **Settings** > **Security** > **Quick delete**, where the user can choose to enable a sliding button on the home screen to quickly delete information from Tella in emergency situations. If enabled, the user can choose exactly what gets deleted when the feature is used. The available options are: -* Delete files: Deletes all files stored in Tella 🗑️ -* Delete draft and submitted forms: Deletes drafts and submitted forms in all Connections. [Visit the For Organizations page](/for-organizations) to discover the available server connections 📝 -* Delete server settings: Deletes all server connections and all the forms, templates or reports associated with them 📋 +* Delete files: Deletes all files stored in Tella 🗑️ . This is the default option. +* Delete Connections: Deletes all your connections, and all data asociated with them (including drafts, outbox and submitted reports). [Visit the For Organizations page](/for-organizations) to discover the available server connections 📝 * Delete Tella: Deletes the app and all the data it contains. It triggers a message asking if the user wants to uninstall Tella as well ❌. :::info Delete Tella -The Delete Tella option might not be available on some Android phones due to technical limitations. We are working on a fix for this issue. For iOS it is not possible to programmatically delete an app. +The Delete Tella option might not be available on some Android phones due to technical limitations. We are working on a fix for this issue. For iOS it is not possible to programmatically delete an app, so the Delete Tella option is not available. ::: ## Quick exit {#quick-exit} From d03379d762c5fc5858401b01199f173c3839359f Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Wed, 8 Apr 2026 20:14:49 +0000 Subject: [PATCH 07/13] Translate _tella-languages.md in ps [Manual Sync] 4% of minimum 1% translated source file: '_tella-languages.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/_tella-languages.md | 21 ++++++++++--------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md index d1a7cd0d..e57e1bcc 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md @@ -3,7 +3,7 @@ 3. Belarusian 4. Bengali 5. Burmese -6. Chinese +6. Chinese (Simplified Chinese) 7. انګریزې 8. French 9. Indonesian @@ -12,12 +12,13 @@ 12. Karen Sgaw 13. Kurdish 14. Malayalam -15. Ndau -16. Persian -17. Portuguese -18. Portuguese (Mozambique) -19. Russian -20. Spanish (Latin America) -21. Tamil -22. Tsonga -23. Vietnamese \ No newline at end of file +15. Mizo +16. Ndau +17. Persian +18. Portuguese +19. Portuguese (Mozambique) +20. Russian +21. Spanish (Latin America) +22. Tamil +23. Tsonga +24. Vietnamese \ No newline at end of file From 5971c38f78966ead6eb6705e69a63429adc872cf Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Wed, 8 Apr 2026 20:15:21 +0000 Subject: [PATCH 08/13] Translate features.md in ps [Manual Sync] 3% of minimum 1% translated source file: 'features.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/Discover Tella/features.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md index 13a8284e..b5732796 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md @@ -63,7 +63,9 @@ On this table we explain what server types are available on the Tella apps: :::danger -For the moment, the submission to any type of server it is **not** encrypted. People who have access to the server itself are able to see the files. +For now, any files you submit to a connection are stored unencrypted on that server or drive. This means that anyone with permission to access the content of that server or drive may be able to view those files. While the connection used to submit files is secured via HTTPS, the files themselves must be decrypted to be accessed outside of the Tella vault. + +We strongly recommend reviewing and understanding the permission model of each connection you use, in order to determine which option is safest and most appropriate for your specific use case. ::: From 27a83572ccc7e6b036e8a65707c8a155d084d6fb Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Tue, 5 May 2026 13:44:25 +0000 Subject: [PATCH 09/13] Translate _tella-languages.md in ps [Manual Sync] 4% of minimum 1% translated source file: '_tella-languages.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/_tella-languages.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md index e57e1bcc..a2e0c9db 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/_tella-languages.md @@ -20,5 +20,6 @@ 20. Russian 21. Spanish (Latin America) 22. Tamil -23. Tsonga -24. Vietnamese \ No newline at end of file +23. Ukrainian +24. Tsonga +25. Vietnamese \ No newline at end of file From 07b0ff8b008322e685017a9e56d8d12211266404 Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Tue, 5 May 2026 13:45:21 +0000 Subject: [PATCH 10/13] Translate security-and-privacy.md in ps [Manual Sync] 1% of minimum 1% translated source file: 'security-and-privacy.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../Discover Tella/security-and-privacy.md | 20 ++++++------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md index eb34ad6a..755707f3 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/security-and-privacy.md @@ -1,8 +1,9 @@ --- id: security-and-privacy -title: Security and privacy +title: Security and Privacy description: Details about Tella security and privacy. slug: /security-and-privacy +sidebar_position: 2 --- # Security and privacy @@ -73,7 +74,7 @@ Tella integrates various security measures in place to achieve an acceptable lev 1. **Encryption at rest**: All data is encrypted at rest, on the user's device. This means that unless the app is unlocked (by entering the user's lock), the data it contains cannot be accessed at all. Even if someone seizes the phone and extracts all the data using a computer, the data will remain unreadable. -2. **Encryption in transit:** All data being transferred between Tella and servers (see [Connections section](/features#connecting-to-servers)) is encrypted through[Transport Layer Security (TLS)](https://en.wikipedia.org/wiki/Transport_Layer_Security). Tella makes it impossible to send data to a server without TLS encryption. +2. **Encryption in transit:** All data being transferred between Tella and servers (see [Connections section](/connections)) is encrypted through[Transport Layer Security (TLS)](https://en.wikipedia.org/wiki/Transport_Layer_Security). Tella makes it impossible to send data to a server without TLS encryption. 3. **Lock**: Tella users [choose a lock](/features#app-lock) for the app as soon as they install it. Password, Pattern and PIN locks are available and each level of security is communicated to the users. 4. **Lock timeout:** Users can also configure a [lock timeout](/features#lock-timeout-configuration), to choose how quick Tella will lock when not in use. By default, the lock timeout is set to ‘immediately’, so as soon as the user exits Tella, the app locks and all of the data is encrypted. 5. **Camouflage**: On Tella Android, there are currently [two camouflage](features#camouflage) modes for Tella: a fully functional calculator and the possibility to change the app name and icon to make it harder to find on the phone. Due to iOS restrictions, it is not possible to camouflage Tella for iOS. @@ -81,6 +82,7 @@ Tella integrates various security measures in place to achieve an acceptable lev 7. **Camera silent mode**: Users can choose to [turn off the camera shutter sound](/features#camera-silent-mode) to draw less attention when taking photos. 8. **Screen security**: By default, Tella blocks screenshots and screen recordings inside Tella and hides the screen preview in the list of recent apps. [This setting](/features#screen-security) can be disabled, for example to record tutorials inside Tella or mirror the app to a computer for a presentation. 9. **Restrict unlocking attempts**: Users can decide how many failed [unlock attempts](features#restrict-unlocking-attempts) are allowed before everything inside Tella is deleted and whether a visual indicator with the remaining unlocking attempts will be visible on the unlock screen or not. +10. **Offline file sharing**: Tella allows establishing a secure connection with devices that are in the same physical location and transferring files encrypted, from one Tella vault to another. [Nearby Sharing](/nearby-sharing) works fully offline, even on insecure networks or networks being surveilled. Nearby Sharing is available cross-platform (between Android, iOS and Desktop). :::tip Video tutorial 🎥 Learn more about Security Features in our [video tutorial](/video-tutorials#additional-security-features) @@ -98,6 +100,7 @@ There is no such thing as an app that is 100% "secure". Security is dependent on * File management: * Files that are exported out of Tella to the device file system are no longer encrypted. This means that anyone with access to the device who browses the file system or gallery may be able to find those files. * Files that are shared through third-party apps may be visible to those apps and saved unencrypted on the device’s file system, and someone searching these apps may be able to find the files. For example: a photo stored inside Tella and shared on WhatsApp will be visible inside WhatsApp, and will also be visible in the file system, where WhatsApp photos are stored. This happens because in order to share with third-party apps the file needs to be saved on the phone file system, which is not encrypted. This is why we recommend manually deleting the file from the device’s file system after sharing it. + * Files sent to a [server connection](/for-organizations) will be stored un-encrypted on the server, unless the server has implemented disk encryption. People who have access to the server might be able to see the files. Tella makes sure that the data travels encrypted to the server but cannot guarantee the security practices of the server. If you choose to connect to a Google Drive or Dropbox instance, or work with a third party organization for hosting your data, we recommend looking into whether the organization itself can access your data. * Importing a file creates a copy of this file, and then imports and encrypts it into Tella. On version 1.1(iOS) and 2.1(Android) we developed a feature for users to select if they want to keep or delete the original file when importing to Tella. However, we recomend to verify the original file is not present on the Trash bin (My files > Trash) and to delete the file from any automatic backup services you have enabled on your phone (Google Photos, Dropbox, etc). @@ -107,23 +110,12 @@ We regularly ask independent security firms to audit our code to ensure it is ro | نېټه | Audited by | Platforms audited | Link | | -----|----------|----|-----------| +| May 2026 | Convocation Research and Design Labs | Android, iOS, Desktop |[Placeholder for report !]| | August 2024 | Radically Open Security | Android, iOS, Android FOSS|[View pen-testing results]()| | May 2024 | Subgraph Technologies, Inc. | Android, iOS, Tella Web|[View updated report confirming fixes has been implemented]()| | May 2023 | Subgraph Technologies, Inc. | Android, iOS, Tella Web |[View security audit]()| -This is the summary from the latest audit and the status of the vulnerabilities identified: - -| عنوان | شدت | Platform | وضعیت | -|-----------------------------------------------------|-------------|-------------|-------------| -| Require re-authentication for changing key security settings | Moderate | ټوليز | Planning | -| Improve webview implementation | Moderate | iOS | Resolved | -| Improve GitHub practices (merging to main and tags) | ټیټ | Android, Android FOSS | Resolved (pending re-test) | -| Increase PBKDF2 iteration counts. | ټیټ | Android, Android FOSS | Soon | -| Do not allow clear-text traffic in Android manifest.| ټیټ | Android, Android FOSS | Resolved | -| Outdated 3rd-party dependencies | Unknown | Android, Android FOSS | Resolved | - - From f41559418cd56083568f721d7b94c98a3c1282f0 Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Tue, 5 May 2026 13:45:47 +0000 Subject: [PATCH 11/13] Translate features.md in ps [Manual Sync] 3% of minimum 1% translated source file: 'features.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/Discover Tella/features.md | 61 ++++++++++++++----- 1 file changed, 45 insertions(+), 16 deletions(-) diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md index b5732796..569d94ff 100644 --- a/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Discover Tella/features.md @@ -1,8 +1,9 @@ --- id: features -title: Tella features +title: Tella Features description: A detailed description of Tella features. slug: /features +sidebar_position: 1 --- import FeaturesTable from '.././_features-table.md'; @@ -47,27 +48,33 @@ If the user hard exit Tella (for example by using [Quick Exit](#quick-exit) or m If [verification mode](/features#verification-mode) is turned on, background encryption is automatically disabled to make sure that all file metadata is captured at the same time as the photo, video, or audio file is saved. ::: -## Backup files to a cloud {#backup-files} -We are in the process of adding options for individuals and organizations to backup their data to different clouds. Backups, for the moment, need to be made manually, by creating reports (using, for example, the date of "today" as the report title) and submitting them to the connected server. Files will be available on the connected server inside a folder with the report title. +## Backup files {#backup-files} +Tella stores all the information locally in your phone. If you delete your files (for example using [quick delete](/features#quick-delete) or if you uninstall Tella), your files cannot be restored unless you have backed them up outside of your Tella Vault. -For the moment we support the following connections. Follow each of the links to find details and step-by-step guides on how to connect and use each of them: -* [Open Data Kit (ODK)](/odk) -* [Uwazi](/uwazi) -* [Tella Web](/tella-web) -* [Google Drive](/g-drive) -* [Nextcloud](/nextcloud) -* [Dropbox](/dropbox) +We offer several alternatives to backup files, so you can safely delete files from Tella and import those back in, but the backup process is manual, for the moment. Please [contact us](/contact-us) if you have questions. -On this table we explain what server types are available on the Tella apps: -. +:::note +All exports outside of Tella's encrypted vault (to a connected server or [to your phone](/features#file-management)) will be unencrypted. The only method for sharing files that transfer files directly to another encrypted vault is [Nearby Sharing](/nearby-sharing). +::: -:::danger -For now, any files you submit to a connection are stored unencrypted on that server or drive. This means that anyone with permission to access the content of that server or drive may be able to view those files. While the connection used to submit files is secured via HTTPS, the files themselves must be decrypted to be accessed outside of the Tella vault. -We strongly recommend reviewing and understanding the permission model of each connection you use, in order to determine which option is safest and most appropriate for your specific use case. +### Backup files to another phone or computer {#backup-files-to-another-phone-or-computer} + +Using [Nearby Sharing](/nearby-sharing) you can transfer files directly to another Tella vault, either in another phone or [to a computer](/get-started-desktop) that's in physical proximity. Files are shared and store encrypted in the other Tella. If you backup to another phone you can use Nearby Sharing again to restore the files to your Tella. + +:::info +For the moment Tella Desktop can only receive files. ::: +### Backup files to a cloud {#backup-files-to-a-cloud} + +Some individuals use commercial clouds (Google Drive, Dropbox, Nextcloud) as a backup system for their Tella data. However, we advise using this feature with caution: +- Automatic backups to any server are **not** currently available. They need to be made manually as submissions to each of the servers. +- Files on the server will be accessible to anyone with server access. + +You can [continue reading about Server Connections and how organizations use Tella here](/for-organizations). + ## Lock timeout configuration {#lock-timeout-configuration} @@ -290,6 +297,10 @@ A Quick Delete button allows users, in just a few seconds, to delete sensitive d The Delete Tella option might not be available on some Android phones due to technical limitations. We are working on a fix for this issue. For iOS it is not possible to programmatically delete an app, so the Delete Tella option is not available. ::: +:::warning +Before triggering Quick Delete, consider [backing up you files](/features#backup-files) outside of Tella, to avoid loosing them. +::: + ## Quick exit {#quick-exit} By clicking the exit button on Tella’s home screen right top corner, Android users can quickly close and lock the app in case of emergency. While having the lock timeout set to “immediately” means that the app already locks when the user exits, using the Quick Exit button adds an extra layer of security and assurance that the app will be fully closed and locked 🔒 @@ -338,7 +349,7 @@ Below is a list of each piece of metadata captured by Tella: ## Connecting to servers {#connecting-to-servers} -Users can collect data directly in Tella, keep the data protected within the app, and connect to a server to securely send the data to a server. This feature is frequently used by organizations who centralize the data collected by volunteers or activist on the ground. These people collect information using Tella on their phones and then send it to their organizations. Previous Tella deployments where on-the-ground users collect data and send it to an organization's server have ranged from 1 to 2,000 users. 📲 📡 +Users can collect data directly in Tella, keep the data protected within the app, and connect to a server to securely send the data to a server. This feature is frequently used by organizations who centralize the data collected by volunteers or activist on the ground. These people collect information using Tella on their phones and then send it to their organizations. Previous Tella deployments where on-the-ground users collect data and send it to an organization's server have ranged from 1 to 2,000 users. 📲 📡. Currently the servers that can be connected to Tella are: @@ -349,12 +360,30 @@ Currently the servers that can be connected to Tella are: * [Nextcloud](/nextcloud) * [Dropbox](/dropbox) +You can [read more about servers and how organizations have been using this feature here](/for-organizations). :::tip Video tutorial 🎥 Learn more about [Connecting to Servers](/video-tutorials#server-connections) in our video tutorials. ::: +## Nearby Sharing {#nearby-sharing} + +Users can share files directly from Tella’s encrypted vault to another Tella encrypted vault in the same physical location using Nearby Sharing . After a quick connection tutorial, the two devices establish a secure link, and files are transferred encrypted from one device to the other. Nearby Sharing is independent of the internet connection status: it works online or offline. + +This feature is available on Tella Android, Tella iOS, and Tella Desktop. + +:::note +[Learn more about nearby sharing here](/nearby-sharing). +::: + +## Share button {#share-button} +To share information with other apps, users can select the file or files they want to share and press the Share button. Tella will prompt the list of available apps on the phone and users can choose the app they want to share the file(s) with. + +:::danger +Tella will share the files unencrypted and the history of exchanged files might be visible on the app you used. We recommend using disappearing messages or deleting the messages after the other person receives them when using messaging apps (for example WhatsApp or Signal). +::: + ## Camera (photos and videos) {#camera-photos-and-videos} Tella offers a built-in camera where you can take photos and videos. All media collected inside Tella will not be available outside of it, as all files get encrypted as soon as they are taken. Files can only be accessed inside Tella, using the lock to open the app. Photos and videos won’t appear on the phone Gallery. In Tella, photos and videos will have a default name, but users can rename those using the Rename button. Files can also be organized in folders. 📷 From 0dfb3db805f5ed53a1edaf806beb120b34ab657f Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Tue, 5 May 2026 13:46:37 +0000 Subject: [PATCH 12/13] Translate uwazi.md in ps [Manual Sync] 15% of minimum 1% translated source file: 'uwazi.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/Connections/uwazi.md | 134 ++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 i18n/ps/docusaurus-plugin-content-docs/current/Connections/uwazi.md diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Connections/uwazi.md b/i18n/ps/docusaurus-plugin-content-docs/current/Connections/uwazi.md new file mode 100644 index 00000000..eb8ce050 --- /dev/null +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Connections/uwazi.md @@ -0,0 +1,134 @@ +--- +id: uwazi +title: Uwazi +description: The Uwazi server connection is available for organizations looking to collect structured data. +slug: /uwazi +--- + +# Uwazi Connection + +[Uwazi](https://uwazi.io/) is an open-source documentation tool developed by [HURIDOCS](https://huridocs.org). It is a flexible, web-based database application designed for human rights defenders to manage their collections of information, including documents, evidence, cases, and complaints. + +Uwazi allows organizations to aggregate, in a central repository, data collected by their members or partners. Tella users connect to their organization's Uwazi instance, download forms (called templates), fill templates as many times as they need (even if they don't have internet connectivity), and upload the data. Organizations can then curate, organize, and publish their data directly from Uwazi. + +Similarly to all other server connections([Tella Web](/tella-web), [Google Drive](/g-drive), [Nextcloud](/nextcloud), [Dropbox](/dropbox), and [Open Data Kit](/odk)), connecting to Uwazi enhances the security of data collected on Tella by: +1. Allowing users to collect data directly inside Tella's encrypted container. +2. Ensuring that data is sent directly from Tella to Uwazi, without having to rely on a third-party tool or app. +3. Allowing users to back up their data on a remote server, to lower the risk that data is discovered on their mobile device. +4. Ensuring that organizations can preserve important information even in the event of device seizure or destruction, and can organize it to use for research, advocacy, or accountability processes. + +:::danger +Even though data is transferred to the server securely (SSL), anyone with access to the Uwazi account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing). +::: + +### Testing Uwazi {#testing-uwazi} + +You can test Uwazi using [this Demo instance](https://demo.uwazi.io/). + +### When to use Uwazi {#when-to-use-uwazi} + +We recommend Uwazi to organizations that need on-the-ground users to collect data in a structured manner through forms. + +Uwazi also allows project managers to easily organize, analyze, visualize, and publish the collected data. It is especially powerful because of its database allows making relationships between entities, which helps connect data points (such as incidents, perpetrators, and victims) to emerge patterns. Uwazi is also great to collect data in many different languages and to facilitate collaboration between teams. + +Uwazi does not have an official mobile app, so by integrating Uwazi and Tella, you can leverage Tella's encryption and offline capabilities and take full advantage of Uwazi's abilities to organize, search, download, visualize, and publish information. + +Here there are some pointers on Uwazi may be particularly suitable to your use case: +- You need to make the data collected publicly accessible on a website. +- You need to establish relationships between data points. +- Data must be contained in structured database registers. +- You need to clean up, edit, organise and curate the collected data. +- You need to quickly search, find and analyse data. +- You work in a multilingual environment. +- You work in a collaborative environment with multiple users and different profiles. +- You need to preserve information in a secure way over the long term. + +You can learn more about Uwazi on [Uwazi's official documentation](https://uwazi.readthedocs.io/en/latest/). HURIDOCS is a great friend of Horizontal, so if you have questions about Uwazi or would like us to connect you to the HURIDOCS team, [contact-us](contact-us). + +:::tip +If you need help figuring out if Uwazi is best for your use-case, [read our guide](/for-organizations) or [contact us](/contact-us)! +::: + +## Configure Uwazi on a server {#configure-uwazi-on-a-server} + + +The HURIDOCS team offers 2 alternatives on how to set up your uwazi server: + +1. Self-hosted: Share this [comprehensive administrator guide](https://uwazi.readthedocs.io/en/latest/sysadmin-docs/index.html) with your system's administrator for step-by-step instructions on how to install Uwazi on your server, configure backups, and set up advanced features. +2. Hosted by HURIDOCS: HURIDOCS offer hosting packages as a service. Free hosting services (up to a storage limit) and a trial version of Uwazi are available for human rights organizations. [Reach out to HURIDOCS](https://huridocs.org/services/) for more details about the service. + +## Model Your Data {#model-your-data} + +An Uwazi collection is made up of Entities. An entity has Properties which are the fields that Tella users will fill to collect data. Entities can hold Primary Documents and/or Supporting Files and some properties that are defined by administrators on the Uwazi server when they create templates. A template is an empty form that can be filled as many times as needed; once a template is filled, it becomes an Entity. + +[You can read here](https://uwazi.readthedocs.io/en/latest/admin-docs/building-info-architecture.html#understanding-properties) about the properties that are available on the Uwazi server and how to model your data and create your templates. For the moment we only support properties and functionalities that have been flagged as high priority by Uwazi users. If you need other properties, [contact us](/contact-us). + +:::info +If Tella users download a template that has properties that are not supported in Tella, those properties won't be shown in the app. However, users will still be able to submit the entities, and admins will be able to access these entities, including all the properties that were filled, without any problems. +::: + +### Available Properties {#available-properties} + +| **Property or Feature** | **Tella Android**| **Tella iOS** | **Tella Android FOSS** | +|------|------|-----|-----| +| Primary and Supporting Documents | ✔️ | ✔️ | ✔️ | +| Plain Text | ✔️ | ✔️ | ✔️ | +| Numeric | ✔️ | ✔️ | ✔️ | +| Single Select | ✔️ | ✔️ | ✔️ | +| Multiple Select | ✔️ | نه | ✔️ | +| Relationship | ✔️ | ✔️ | ✔️ | +| Single Date | ✔️ | ✔️ | ✔️ | +| Multiple Date | ✔️ | نه | ✔️ | +| External Link | ✔️ | نه | ✔️ | +| Rich Text | ✔️ | ✔️ | ✔️ | +| Single and Multiple Date Range | ✔️ | نه | ✔️ | +| Attach Media (Image, Video, or Audio) | ✔️| ✔️ | ✔️ | +| Geolocation | ✔️ | نه | ✔️ | +| Generated ID | ✔️ | نه | ✔️ | + + +## Get People on the Ground Ready to Start Submitting Data {#get-people-on-the-ground-ready-to-start-submitting-data} + +### Connect to the Server {#connect-to-the-server} + +In order to connect to an Uwazi server: + +* Navigate to **Settings ⚙️** > **Connections** > **+** +* Select "Uwazi" from the list of available server types. +* Enter the organization’s Uwazi server URL (generated and provided by admins). +* Choose between: + * **Log In:** if a username and password were provided by admins. + * **Public Access:** if the server is configured to accept anonymous submissions. +* If the server requires two-factor authentication, enter the one-time code. +* Choose the **Language** in which you want to display templates. + +:::info +You can watch [this video](/video-tutorials#uwazi) on how to connect to an Uwazi server from the Tella. +::: + +### Send Your Information {#send-your-information} + +Once you successfully connected to an Uwazi instance, you'll see a new card with the label "Uwazi" in the **Connections** sections of your Tella homescreen. + +To download a template, tap the **+** button at the bottom of the screen. You will see a list of templates that are available to you on all the Uwazi instances you are connected to. Tap on the **Download** button to download templates or the **Refresh** button to see if there are updates to the templates available to you on the server. + +Then go back to the Uwazi main screen and tap the template you want to use to create an entity. + + +#### Data Submission Alternatives {#data-submission-alternatives} + +| **Feature** | **Details**| **Tella Android** | **Tella iOS** | +|------|------|------|------| +| سپارل | Send the filled form to the connected server. | هو | هو | +| Save as draft | Save a form that's not completed. | هو | هو | +| Submit later | Mark a form as ready and send it to the Outbox tab. | هو | هو | +| Drafts Tab | A tab with all drafts. Drafts can be edited or deleted. | هو | هو | +| Outbox Tab | A tab with forms ready to submit. Forms on the outbox tab can be edited or deleted. | هو | هو | +| Submitted Tab | A tab with all forms that have been successfully sent to the server. Submitted forms can be deleted. | هو | هو | +| Pause/Resume submission | Users can manually pause a submission and resume it when ready. | هو | نه | +| Automatically pause submission when offline | Submissions will be sent to the Outbox tab if submission fails due to connectivity issues. | هو | هو | + + +:::tip +If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing). +::: From 578e0cccb7a4529ff870c6e4fa6ac7c68aa38bef Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Tue, 5 May 2026 13:47:03 +0000 Subject: [PATCH 13/13] Translate odk.md in ps [Manual Sync] 11% of minimum 1% translated source file: 'odk.md' on 'ps'. Sync of partially translated files: untranslated content is included with an empty translation or source language content depending on file format --- .../current/Connections/odk.md | 144 ++++++++++++++++++ 1 file changed, 144 insertions(+) create mode 100644 i18n/ps/docusaurus-plugin-content-docs/current/Connections/odk.md diff --git a/i18n/ps/docusaurus-plugin-content-docs/current/Connections/odk.md b/i18n/ps/docusaurus-plugin-content-docs/current/Connections/odk.md new file mode 100644 index 00000000..e5d68de4 --- /dev/null +++ b/i18n/ps/docusaurus-plugin-content-docs/current/Connections/odk.md @@ -0,0 +1,144 @@ +--- +id: odk +title: Open Data Kit (ODK) +description: The Open Data Kit server connection is available for organizations looking to collect structured data using forms. +slug: /odk +--- + +# Open Data Kit (ODK) Connection + +The [Open Data Kit (ODK)](https://getodk.org/) is an open standard used to create custom forms and collect data. + +An Open Data Kit server allows organizations to aggregate, in a central repository, data collected by their members or partners. Tella users connect to their organization's ODK instance, fill forms as many times as they need (even if they don't have internet connectivity), and upload the data. Organizations can download the data from the server or analyze it on the server, depending on the chosen server alternatives. + +Similarly to any other server connection (like [Tella Web](/tella-web), [Google Drive](/g-drive), [Dropbox](/dropbox), [Nextcloud](/nextcloud) or [Uwazi](/uwazi)), connecting to the ODK server enhances the security of data collected on Tella by: + +1. Allowing users to collect data directly inside Tella's encrypted container. +2. Ensuring that data is sent directly from Tella to the ODK server, without relying on a third-party tool or app. +3. Allowing users to back up their data on a remote server, to lower the risk that data is discovered on their mobile device. +4. Ensuring that organizations can preserve important information even in the event of device seizure or destruction, and can organize it for research, advocacy, or accountability processes. + +:::danger +Even though data is transferred to the server securely (SSL), anyone with access to the ODK account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing). +::: + + +### Choosing and Installing Your ODK Server {#choosing-and-installing-your-odk-server} + +Because ODK is an open standard, Tella can be used with any of the tools that are ODK-compliant. + +For civil society organizations and human rights defenders, we recommend using [KoboToolbox](https://www.kobotoolbox.org/) to create forms with custom questions, manage users, and aggregate the data submitted by users. Based on our experience, KoboToolbox is user-friendly and flexible, and it is also open source. KoboToolbox offers a [community plan for non-profits](https://www.kobotoolbox.org/pricing/) and offer free training resources and guidance on how to structure the data on the server (Self-serve learning base and Community Forum). It is also possible [to use a private instance of KoboToolbox](https://www.kobotoolbox.org/services/private-servers/) or [self-host it](https://support.kobotoolbox.org/kobo_your_servers.html). + +:::tip +We are work closely with the Kobotoolbox team. If you are interested in using the Tella-KoboToolbox connection and would like some support or to discuss the best hosting plan for your use case, please [contact us](/contact-us). +::: + +There are other ODK-compliant apps available, like [Ona](https://ona.io/home/) or [ODK Cloud](https://https://getodk.org/index.html). Tella works with any of these. + + +### When to Use ODK {#when-to-use-odk} + +We recommend ODK to organizations that need on-the-ground users to collect data in a structured manner like forms. We also recommend it to organizations that don't have the technical capacity to install and maintain a server and want to use a ready-to-use cloud instance. If you use a cloud instance, remember that the organization hosting your ODK instance will be able to access your data. This is an important consideration when deciding whether to self-host or use a cloud service. + +ODK and KoboToolbox are widely used, well-documented, and easy to use. There are guides available, and they offer support to non-profit organizations on how to structure and maintain their data. + +:::tip +If you need help figuring out if ODK is best for your use-case, [read our guide](/for-organizations) or [contact us](/contact-us)! +::: + +## Model Your Data {#model-your-data} + +KoboToolbox offers a detailed guide on how to create your project and add questions to your forms, and how to deploy them to make them available to on-the-ground users [here](https://support.kobotoolbox.org/overview_of_creating_a_project.html). + +## Connect Tella to an ODK Instance to Collect Data {#connect-tella-to-an-odk-instance-to-collect-data} + +In this documentation, we focus on how to collect data using Tella. There are alternative mobile apps that can be used to collect data on ODK, including the ODK Collect Android app. You can see a comparison of these alternatives [here](/faq#how-is-tella-different-from-other-documentation-apps). + +:::info +The ODK connection is not available for Tella iOS. +::: + +### Connect to an ODK Server {#connect-to-an-odk-server} +After creating and deploying a Form using any ODK-compliant server, in Tella, go to **Settings** > **Connections** > **+** > **Open Data Kit (ODK)**. Fill the following fields: +- **Server Name**: A descriptive name for your server in Tella. The name you select is only visible in the app and does not impact the ODK connection. +- **Server URL**: Your server URL. For example, `kc.kobotoolbox.org` if you are using the KoboToolbox public server. +If your server requires user authentication, tap the **Advanced** button and enter your **Username** and **Password**. Your server's administrator should provide all this information to you. + + +### Fill forms {#fill-forms} + +After you successfully connected to the ODK instance, you'll see a new card called "Forms" in the **Connections** sections of the Tella homescreen. + +After you enter the **Forms** section, you will see a list of Forms available to you on the instance(s) that you are connected to. Using the **Download** button you can download forms to Tella so that you can fill them, even if you are not connected to the internet. + +You can tap on each blank form to start filling it. + + +#### Submit forms {#submit-forms} + +As you collect data and fill forms the following options are available to increase offline support on Tella: +- Submit: send the filled form to the ODK server. +- Save as draft: save a form that is not completed so you can continue working on it later. +- Submit later: mark a form as complete to submit it a later point. Until it is sent, it will be available in the Outbox tab. +- Drafts tab: a tab with the list of all draft forms. Drafts can be edited or deleted. +- Outbox tab: a table with the list of all forms ready to be submitted. Forms in the Outbox tab can be edited, deleted, or submitted. +- Submitted tab: a tab with the list of all forms that have been successfully sent to the server. Submitted forms can be deleted. +- Pause/Resume submission: you can manually pause a submission and resume it when ready. +- Automatically pause submission when offline: forms will be sent to the Outbox tab if the submission fails due to connectivity issues. + +### Supported Question Types {#supported-question-types} +Below is an overview of the ODK question types that are supported in Tella Android. If there is a question type that isn't supported in Tella and that is critical to your workflow, please [contact us](/contact-us). + +| **Question type** | **Tella Android** | +|------|------| +| Select One | ✔️ | +| Select Many | ✔️ | +| متن | ✔️ | +| Number / Decimal | ✔️ | +| نېټه | ✔️ | +| Time | ✔️ | +| Date & time | نه | +| Point (calculate my current location) | ✔️ | +| Point (show my location on a map) | ✔️ | +| Point (let me choose my location on a map) | ✔️ | +| Line | نه | +| Area | نه | +| Photo | ✔️ | +| Photo signature (handwrite my signature) | ✔️ | +| اډیو | ✔️ | +| ویډیو | ✔️ | +| فایل | ✔️ | +| Note | ✔️ | +| Barcode / QR Code | نه | +| Acknowledge | ✔️ | +| Rating | ✔️ | +| Question Matrix | نه | +| Ranking | ✔️ | +| Calculate | نه | +| پټ شوي | نه | +| Range | نه | +| External XML | نه | + +### Supported Features {#supported-features} + +Below is an overview of the ODK features that are supported in Tella Android. If there is a feature that isn't supported in Tella and that is critical to your workflow, please [contact us](/contact-us). + +| **Feature** | **Tella Android** | +|------|------| +| [Offline data collection](/odk#submit-forms) | ✔️ | +| [Form logic](https://docs.getodk.org/form-logic/) | ❌ | +| [Requiring responses](https://docs.getodk.org/form-logic/#requiring-responses) | ✔️ | +| [Setting default responses](https://docs.getodk.org/form-logic/#setting-default-responses) | ❌ | +| [Triggering calculations on value change](https://docs.getodk.org/form-logic/#triggering-calculations-on-value-change) | ❌ | +| [Validating and restricting responses](https://docs.getodk.org/form-logic/#validating-and-restricting-responses) | ❌ | +| [Conditionally showing questions](https://docs.getodk.org/form-logic/#conditionally-showing-questions) | ✔️ | +| [Groups of questions](https://docs.getodk.org/form-logic/#groups-of-questions) | ✔️ | +| [Repeating questions](https://docs.getodk.org/form-logic/#repeating-questions) | ✔️ | +| [Filtering options in select questions](https://docs.getodk.org/form-logic/#filtering-options-in-select-questions) | ✔️ | +| [Generating select ones from repeats](https://docs.getodk.org/form-logic/#generating-select-ones-from-repeats) | ❌ | +| [Form metadata (background data collection)](https://docs.getodk.org/form-audit-log/) | ❌ | + + +:::tip +If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing). +:::