S3 batch upload access is by request only. Contact [email protected] if you would like to use S3 for uploading your scans or texture imports.

Setup

  1. Bandicoot will create a new AWS S3 storage bucket for your exclusive use
    1. You can use this bucket for uploading Bandicoot scans containing RAW photos only
    2. If you use this bucket for any other purpose, we will revoke your access
    3. Bandicoot will periodically delete files that are older than 30 days
  2. We will provide you with login details for your bucket
    1. The login details are
      1. Bucket name
      2. Access key ID
      3. Secret access key
    2. You must store these login details securely like you would a sensitive password
    3. Only share the bucket login details with staff from your own company who need to use them for Bandicoot uploads
    4. Do not share these bucket login details with anyone else
    5. Bandicoot will never ask you to tell us your bucket login details
    6. If you accidentally disclose your bucket login details, contact Bandicoot and we will revoke your key and give you a new one
  3. Install and configure software on your computer for uploading to S3
    1. Popular options include:
      1. GUI tools: Cyberduck, FileZilla Pro, WinSCP, S3 Browser, Transmit, Forklift, Commander One Pro
      2. CLI tools: AWS CLI, Rclone, s5cmd
    2. Switch on Transfer Acceleration to increase your upload speed
  4. Connect to your bucket using your S3 software and the login details we gave you to check that everything is working
  5. Use S3 Transfer Acceleration in your S3 software for faster uploads

Uploading a batch of scans

  1. Organise your photos into folders, with a single scan in each folder
  2. Set the name of each folder to the name of the material
  3. Add a new batch folder on AWS S3 using details supplied by Bandicoot
  4. Upload your scan folders into the batch folder on AWS S3
  5. Log into the Bandicoot web app and switch to the Create screen
    1. Select the 🪣 Upload photos via S3 tab
    2. Copy the S3 path to the batch folder then paste it into the S3 path entry
  6. Click: Process scans
  7. After a few moments, the scan folders from inside your batch folder will appear as new materials on the Processing screen
  8. After each scan is imported, a file called 00_SCAN_IMPORTED.json is added to the scan folder on your S3 bucket
    1. This means the photos from that scan folder have been imported into our scan processing storage, and it is safe for you to delete the scan folder folder from your S3 bucket

For example if you name your batch folder batch 1:

  1. Inside batch 1 arrange multiple sub-folders
  2. Each sub-folder contains the photos for one scan