Introduction

TwinCapture is a mobile application used for capturing site conditions with a 360° camera and uploading them to CupixWorks. The end-to-end workflow spans from project selection and site capture with a 360° camera to data upload, ensuring that field conditions are accurately recorded and synchronized with project workflows.

Note:

• This guide reflects the features and updates available in TwinCapture version 3.0 and later. Ensure the app is updated to access the latest features.
• To use the Insta360 X5 with TwinCapture 3.0, the camera firmware must be version 1.6.18 or later. Confirm that the X5 firmware meets this requirement. The latest firmware is available for download here or through the Insta360 mobile app (version 2.10.0 or later is required for this firmware upgrade).
• To upload captures via CupixConnect, set Upload Setting to CupixConnect in Settings. After capture, metadata is uploaded automatically and the capture data must be uploaded from a desktop using CupixConnect.

Install and Sign In

Note: Please confirm that your mobile device meets the minimum requirements below.

• iOS: A12 chip or newer, iOS 14.2+
• Android: Android 10.0+ or HarmonyOS 2.0.0+
• Landscape mode is supported on tablet devices as of TwinCapture 3.1.0.

1. Search “TwinCapture” in the App Store (iOS) or Google Play (Android), then install the app.

   

2. Open the app and sign in with your Cupix account:

   

3. Enter your Team URL, then log in with your email and password.

   Note: Ensure the region is set correctly before signing in. You can change it from the top-right corner.

4. Check your email for the verification code and complete two-step verification.

Start a Capture

1. Select the assigned project. The app will automatically download the project files.

   

2. Choose a level and reference plan, then tap Capture.

   Note: Tap the project name at the top to switch projects.

   

3. Select your capture mode:

   

   • 3D Map – 20-min video, generates a virtual tour and 3D Dollhouse (default).
   • 360° Video – 60-min video, generates a virtual tour.
   • 360° Photo – Single images, manually positioned.
   • 360° VideoDrive (Beta) – 20-min video at 20–30 km/h, GPS-aligned.

   Note:

   • Project Admins may restrict available capture modes, so not all modes may be visible.
   • 360° VideoDrive mode must be enabled under Settings > Beta Features.
   • For more information, see the Capture Mode Overview article.

4. Set the starting point on the reference plan or map, then tap Confirm Start Point.

   • If the camera is already connected, recording will begin automatically.
   • If this is the first capture, proceed to the next step to connect the camera.

    

   Note:

   • The map view appears in the background with the selected plan only for georeferenced projects.
   • Screen options:
     • Tap the level name at the top to switch levels and reference plans.
     • Tap the capture mode name to switch modes.
     • Use your fingers to move or zoom the plan.
     • Rotation: Rotate reference plan in 45° steps.
     • Arrows: Show or hide navigation arrows.
     • Reposition: Return to your current location on the reference plan or map.
     • Heatmap: The Coverage Heatmap displays a visual overlay on the Floorplan page showing which areas of a level have been captured.
       • Date Range: Adjust the capture date range to plan for next capture.
         • Note: On Android devices, the heatmap may not appear immediately due to a known issue. Move the map slightly to refresh the display.

5. Power on the 360° camera and wait about 20 seconds. The app will automatically detect nearby cameras.
   

   Note:

   • Refer to the Supported 360° Cameras article for the list of supported models.
   • Bluetooth and location permissions must be enabled to connect the camera.
     

6. Select the camera model and tap Connect. Then join the camera’s Wi-Fi network by tapping Join (iOS) or Allow/Connect (Android).
   
7. Once the camera is connected, a 3-second countdown begins and recording starts automatically.
   

Record a Capture

3D Map / 360° Video

1. Walk through the site at a normal pace.

   Note:

   • You can add VoiceNotes or PhotoNotes during recording. See the Create OmniNotes During Capture section in OmniNotes article for details.
   • For detailed guidance and best practices, refer to the Video Capture article.

2. Swipe Slide to Stop to finish recording.
3. Upload the capture or start another one as needed.

Note:

• The connected 360° camera’s battery level and storage status are displayed in the top-right corner.
• Push notifications are sent when 5 minutes and 1 minute remain in the time limit. To receive them, make sure notification settings for TwinCapture are enabled on the device.

360° Photo

1. Place the camera at the capture point.
2. Tap the circle button to take a photo.
3. Move the camera and repeat as needed.

Note: For detailed guidance and best practices, refer to the Single Shot Best Practices article.

VideoDrive (Beta)

Refer to the 360° VideoDrive Capture article.

Upload Captures

There are two ways to upload captures.

• Mobile Upload (Default)
• Web Upload via CupixConnect

Mobile Upload (Default)

1. Open the Upload page in the app to begin the mobile upload. This can be done either immediately after a capture or from the main page by tapping Upload.
      

2. If the camera is disconnected, reconnect it.

   Note: If the capture was taken with one camera, the app will reconnect it automatically. If multiple cameras are available, select the one you want to use from the list.
   

3. The app transfers files from the camera to your phone.
   

   Note: Ensure your phone has enough free space (capture file size + 500 MB). Files are removed from the phone after successful upload.

4. After transfer, the app uploads the files to CupixWorks.
   
5. When upload finishes, you’ll see Upload Done. Tap Back to Main to return.
   

Note:

• To cancel the upload, tap the X button in the top-right corner.
• If multiple cameras were used, TwinCapture uploads each in turn. Tap Try Again to complete remaining uploads.
• If you see Upload Incomplete (some captures failed) or Upload Failed (none uploaded), retry the upload. If the problem continues, contact support.

Web Upload via CupixConnect

When Upload Setting is set to CupixConnect, the app uploads metadata only from the mobile device. 

When capture is complete, only the metadata of captures will be uploaded. The capture data must be transferred to a desktop and uploaded using CupixConnect.

Main Page & Settings

Main Page

• Tap the project name to switch projects.
• Pending uploads appear if captures remain to be uploaded.
• If a camera is connected, tap its name to view details (status, serial number, battery, storage) or disconnect.

• When Upload Setting is set to CupixConnect, a banner is displayed showing the number of captures ready for upload. Tap Learn about CupixConnect for instructions on completing the upload from your desktop.

Settings Menu

From the main page, tap theSettings button in the top-right corner to view the following options:

• Current Team & Project - View team and project information
• Activity - View or reconfigure capture records
• Contact Support - Report issues or ask questions
• Manage App Storage - Free up space by clearing stored data
• Beta Features - Enable experimental features not yet available by default
• Upload Settings - Select the upload method for captures
  • Mobile Upload (default) - Uploads all capture data directly from the mobile device
  • CupixConnect - Uploads metadata only from the mobile device; capture data must be uploaded from a desktop using CupixConnect
• Sign Out - Log out of the current account

Export OmniNotes

If OmniNotes (PhotoNotes or VoiceNotes) have been created during recording, they can be exported to the device or shared directly from the TwinCapture app.

1. Go to Settings → Activity.

2. Select the desired level, and the created OmniNotes will appear below. Tap Select to choose the files to export.

   

   Note: Use the PhotoNotes or VoiceNotes tab to switch between note types.

3. After selecting the files, tap Share to export or share them.

   

Recover Capture Data (Reconfigure)

When network issues cause capture data to be lost, you can reconfigure it to recover the data and complete the upload.

Note: Use this feature only when instructed by Support.

1. Go to Settings → Activity.
2. Select the desired level, then tap the capture to reconfigure.
3. Tap Reconfigure Capture Info → Reconfigure.
4. Upload the recovered data, then re-upload the files.