Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Uploading

Drag and Drop

Drag files or folders from your file manager onto the Crabdrop window. A confirmation dialog appears asking whether to encrypt the files before upload.

Upload Types

Crabdrop automatically chooses the upload method based on file size:

File SizeMethodDetails
< 100 MBSimple uploadSingle PUT request
>= 100 MBMultipart uploadSplit into 50 MB chunks, 6 uploaded at once

Multipart Uploads

Large files are split into 50 MB parts and uploaded concurrently with a maximum of 6 parallel uploads. This significantly speeds up large file transfers. The progress panel shows which part is currently uploading.

Folder Uploads

Entire folders can be uploaded. Crabdrop recursively walks the directory and uploads each file, preserving the folder structure. A progress indicator shows how many files have been uploaded out of the total.

Upload Progress

The upload panel at the bottom of the screen shows:

  • File name
  • Progress percentage
  • Current part number (for multipart uploads)
  • Total bytes uploaded

Multiple uploads can run simultaneously — each gets its own progress entry.

Encryption on Upload

When dropping files, you’re asked whether to encrypt them. If you choose yes:

  1. A UUID is generated as the S3 key (hiding the real filename)
  2. The file data is encrypted in 1 MB chunks using XChaCha20-Poly1305
  3. The UUID-to-filename mapping is stored in an encrypted metadata file in the bucket

See Encryption for details.