CapacitiesDocs

Media Upload

Media is an essential part of our knowledge and therefore also an important part of Capacities. To make the handling of all relevant files as effortless as possible, we have built a highly robust and optimized pipeline that ensures working with images, PDFs, audio recordings, and other files is as smooth as possible. This pipeline processes, optimizes, and synchronizes all your existing and future files in the background, so you don't have to worry about anything.

Media is an essential part of our knowledge and therefore also an important part of Capacities. To make the handling of all relevant files as effortless as possible, we have built a highly robust and optimized pipeline that ensures working with images, PDFs, audio recordings, and other files is as smooth as possible. This pipeline processes, optimizes, and synchronizes all your existing and future files in the background, so you don't have to worry about anything.

To enable you to work with your media from anywhere, even with a weak internet connection, all your media is stored locally and is thus available offline. Once a stable internet connection is restored, your files will be automatically uploaded and made available on all other devices. Read more about Offline Support here.

Depending on which tier you are in, the following restrictions apply regarding media files in Capacities:

BasicProBeliever
Limit / File100 MB100 MB100 MB
Limit / Month100 MBUnlimitedUnlimited
General Storage Limit5 GBUnlimitedUnlimited

Individual files can be uploaded up to a size of 100 MB. For users of Capacities Pro and Believer, there are no monthly or total storage space restrictions regarding media files compared to the Basic tier.

Errors

Although the pipeline is designed to be as robust and stable as possible, occasional errors can still occur:

Uploading Failed

This error occurs if the upload process could not be completed successfully. Possible reasons include:

  • The upload was started but could not be completed (e.g. due to an unstable internet connection or because the app was reloaded).
  • Communication with the storage servers is blocked by a firewall or similar restrictions.
Ensure that you have a stable internet connection and that communication with our servers is not blocked by a firewall. If you are using Capacities at work, check whether the connection to our servers and Amazon S3 is allowed.
If you lose your internet connection, the upload process will resume as soon as a connection is re-established. Until then, your media will only be available on the device where it was uploaded.

Under very special circumstances, the following error may also occur:

Critical Upload Error

If the upload fails and there is insufficient storage available space available on the device, a “Critical Upload Error” will occur. This means that the file will be removed after the app is reloaded and cannot be restored.

If this error occurs, the uploaded file will neither be available on this device nor on all other devices after reloading the app and cannot be restored. In this case, the object must be deleted and the file uploaded again.

Updating Failed

To ensure that you always have the latest versions of your media files available in the app, they are updated at regular intervals. The same errors may occur as in the "Uploading Failed" section.

Processing Failed

Before your files are uploaded to our servers, they are processed locally on your device. Relevant metadata, such as image dimensions, are extracted or preview images of PDFs are created. If this process fails, possible reasons include:

  • The uploaded file is corrupt and cannot be processed.
  • Metadata extraction failed during processing.
If this task fails, ensure that the file is not corrupt. Open the file locally on your device and check if it is displayed correctly and functions as expected. If not, the file is damaged and unusable.

Downloading Failed

This error occurs if there are problems downloading the files. Possible reasons include:

  • The download was started but could not be completed (e.g. due to an unstable internet connection or because the app was reloaded).
  • Communication with the storage servers is blocked by a firewall or similar restrictions.
Ensure that you have a stable internet connection and that communication with our servers is not blocked by a firewall. If you are using Capacities at work, check whether the connection to our servers and Amazon S3 is allowed.
If you lose your internet connection, the downloading process will resume as soon as a connection is reestablished. Until then, your media will only be available on the device where it was downloaded.

Deleting Failed

If a file has been deleted, Capacities will attempt to also delete the cached file after 30 days to free up disk space. This process may fail. However, this is not a problem as the app will still work as usual.

You do not have to worry about anything if this error occurs, as it is a non-critical, internal error.

File Type Not Supported

This error occurs when attempting to upload a file with an unsupported file type. Possible reasons include:

  • The file extension of the selected file is not supported.
  • Incompatibility between the file type and the selected media type.

The following table shows all supported file extensions for the respective media types:

Media TypeSupported Extensions
Image*.png, *.jpg, *.jpeg, *.gif, *.svg, *.webp
PDF*.pdf
Audio*.mp3, *.ogg, *.wav, *.m4a
FileAll
Ensure that the selected file is supported and compatible with the selected media type.

Maximum File Size Exceeded

We currently allow the upload of files up to a size of 100 MB per file. If a file exceeds this limit, the upload attempt will fail.

BasicProBeliever
Limit / File100 MB100 MB100 MB

For Capacities Basic users, there is also a monthly upload limit of 100 MB and a general storage limit of up to 5 GB. Capacities Pro and Believer users have no monthly or total storage limits. See the section "Storage Quota Exceeded"" for more information.

Ensure that the selected file does not exceed the file size limit of 100 MB. If you are on the Capacities Basic tier and have reached the upload and storage limits, consider upgrading to Capacities Pro or Believer.

Storage Quota Exceeded

For Capacities Basic users, there is a monthly upload limit of 100 MB and a general storage limit of up to 5 GB. If these limits are exceeded, the process will fail. Capacities Pro and Believer users have no monthly or total storage limits.

BasicProBeliever
Limit / Month100 MBUnlimitedUnlimited
General Storage Limit5 GBUnlimitedUnlimited

There is also a file size limit of 100 MB per file. See more information about "Maximum File Size Exceeded".

If you are on the Capacities Basic tier and have reached the upload and storage limits, consider upgrading to Capacities Pro or Believer if you want to upload more files.

Insufficient Local Storage

Capacities stores the selected files locally on your device to process and upload them. This is also necessary to retry a failed upload after an interruption or app reload. This error occurs if:

  • You do not have enough available storage on your device.
  • Storage options for the app have been limited by your browser or other means.
Ensure you have sufficient storage space available to ensure these functions work properly. If your device, browser or you have restricted storage options, check whether you can remove these restrictions. You may also need to grant Capacities additional permissions due to privacy settings.
The system will attempt to upload the file even if there is insufficient local storage. However, if the file cannot be stored locally and the upload fails, reloading the app will remove the file and prevent it from being restored. See "Critical Upload Error"" for more information.

Miscellaneous Error

This category includes any other errors that do not fit into the specific types mentioned above. It encompasses unexpected errors, failures, or other unforeseen issues.

Why Capacities is not end-to-end encrypted

Offline Support