Be aware our website uses cookies to give you the most relevant experience by remembering preferences and repeat visits. By clicking “Accept”, you consent to the use of ALL cookies. At any time, you may visit Cookie Settings to review your settings and provide controlled consent.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Privacy Overview

This website uses cookies to improve your experience and for better navigation of the website. Out of these cookies, those that are categorized as necessary are stored on your browser. These necessary cookies are essential for the basic functionalities of the website. We also use third-party cookies to help us analyze and understand how you use this website. All cookies necessary will be stored in your browser only with your consent. You may also choose to opt-out of these cookies, but opting out of some might have an effect on your browsing experience.


All necessary cookies are essential for proper functionality of the website. This category includes only cookies which ensure basic functionalities and security features. These cookies do not store any personal information.

Always enabled
Marketing cookies

By accepting the use of cookies for the purpose of marketing, you consent to the processing of your information regarding your use of our website for Google Ads. In this way, Google can display relevant PhotoRobot ads during your internet browsing. You may choose to opt-out of cookies for the purpose of marketing at any time by changing your Cookie Settings.


Analytical cookies are in use to understand how visitors interact with the website. These cookies help to provide us information on the number of visitors, bounce rate, traffic source, etc.

Save & Accept
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Getting Started - PhotoRobot User Support

PhotoRobot Controls App (further referred to as “CAPP”) is designed to automate content production processes (images, videos, 360s, and 3D models). This guide consists of 4 sections, each representing the process:

  1. SETUP - Create a workspace: cameras, hardware, and projects.
  2. CAPTURE - Control PhotoRobot hardware and cameras, capture images and video
  3. EDIT - Post-process visual content
  4. PUBLISH - Generate output images in multiple formats, “manage profiles”

Installing PhotoRobot Controls App

To install PhotoRobot Controls App on your computer, login to your PhotoRobot account and go to Downloads:

PhotoRobot Controls App download


Compatible Cameras

Important: To make sure CAPP communicates with your camera properly, please close all other programs that connect to the camera. Also be sure to use a compatible camera. This includes recent Canon DSLRs and mirrorless camera models.

Compatible Lights

For CAPP to communicate with lighting, be sure to use compatible lights. These include two types of lights: strobe lights from FOMEI and Broncolor, and any type of LED lights with DMX support.

Creating a Workspace

After opening CAPP, typically the first thing a user does is create a workspace. A workspace is a list of hardware that is being used for a particular photoshoot. It can include various PhotoRobot modules, cameras, lights, and other accessories. 

For demo purposes, users can work with a predefined, Sample Workspace, which is configured to use virtual hardware. In this way, users can still experiment with various features of CAPP by selecting virtual robots and cameras.

Creating PhotoRobot Virtual Workspace

Connecting Hardware

To start using actual (as opposed to virtual) hardware, make sure the hardware is connected to the same computer network (or a sub-network) as the computer you are using to control your PhotoRobot. Your camera must be connected to the computer via USB. Wireless connections are currently not supported. 

When adding a piece of hardware to a workspace, you can check whether it is online (and recognized by CAPP). To do this, look at the dot to the left of the name of the given piece of equipment. If it is recognized, the dot turns green, as seen in the following image.

Add product photography workspace menu

A gray color signalizes that the hardware was not recognized or is not turned on. For possible causes of this, please refer to the Troubleshooting PhotoRobot Manual.

Managing Files - Projects, Items, and Folders

In CAPP, images are organized into projects, items, and folders. 

  • A project is the highest-level data entity. Typically, a project will include items from a single photoshoot or perhaps a single shooting day/week. 
  • Projects consists of one or more items. A single item will typically be a specific, photographed object.
  • An item includes one or more folders. In CAPP, you can have multiple folders in a single item in order to keep different kinds of images separate. A very common example is to have one folder for a 360° rotating presentation (called “spin”), while using another to store still images (“stills”).

To start shooting, you must first add a new project (unless you already have one that you would like to use), as well as at least one item.

( ! ) - If experiencing issues, find additional support for connecting cameras, robots, lights, and editing in the PhotoRobot Troubleshooting Manual.

Capture Mode Interface

After clicking on an item, you will be taken to a capture/edit interface. The controls available to you change based on whether the capture mode is active, or the edit mode. The capture mode is used to control the photography sequence, while the edit mode controls all post-processing performed within CAPP. The active mode will be highlighted at the top of the screen:

Image capture mode user interface

Adding a Spins, Stills, or Video Folder

Before any photoshoot, you must create at least one folder. The main types of folders are spin (used for 360° presentations), stills (for still images), and video (for videos).

Add folder for spins, still images, or product videos

Creating a Spins Folder

When adding a spin folder, CAPP will automatically add stops (also called “frames”) based on how many images per spin you select. The default number is 36, and this can be changed in the bottom left corner. With a higher number of stops, the rotation will be smoother, but it will also take up more storage space.

Select number of frames for 360 spin

Creating a Stills Folder

If you select a stills folder, you must add your stops manually. This will include a turn angle (the rotational angle) and a swing angle (the vertical position of the camera along a circular trajectory). The swing angle is important if you are using our Robotic Arm or another module that can change the horizontal position of the camera.

Add frame for still image folder

Control Compatible Lights

When using lights compatible with CAPP, you are able to select lights in the bottom right corner of the edit mode window.

Photo studio lighting control interface

Capture Mode Interface Overview

The central part of the capture mode interface includes the preview window, which either displays the currently selected image (if you have already taken some) or the live view streamed from the camera.

Live View, which is useful if you want to check composure and focus, can be toggled in the camera control area in the central part of the control bar on the right-hand side of the screen.

Image capture mode overview

Taking Test Shots

Before taking final images, it is a good idea to take one or more test shots. The easiest way to do this is by pressing the T key on your computer keyboard. This will help you check whether you should change the settings of your lights, camera, etc. Test images are stored in the “test shot” folder, which you can access in the bottom left part of the screen.

How to take test shots

Starting a Photography Sequence

When satisfied with the settings, which were verified by taking a test shot, it is time to run the photography sequence. This can be triggered by pressing the space bar on your keyboard or by clicking the “start” button shown in the picture below.

Start product photography sequence

If you have a barcode scanner, you can also trigger the sequence by scanning a special “start” bar code, which you can download here.  

You will know that the sequence has finished successfully if all thumbnails on the left-hand side have been filled with images. It is a good practice to pay attention to any potential misfires of the strobe lights. 

If any of the thumbnails are darker compared to the others, lower the rotation speed or, if necessary, check the condition of your lights. You can then mark these images and reshoot them without having to run the entire sequence again.   

Once the capture sequence is complete, you can switch to edit mode, which is where you will perform post-processing.

How to access PhotoRobot edit mode

Wizards Mode Overview

Wizards mode in CAPP functions as an alternative to manual hardware, camera, and sequence configuration. In use, this mode enables an administrator or photographer to create different Wizards to simplify capture mode for production-line operators.

On creation, a Wizard stores Presets and Workspace configurations, as well as predefined steps operators must follow. Operators cannot adjust any settings, and they must complete the instructions in each step before they can move onto the next process.

Note: Wizard steps are defined in a JavaScript-like language format, and scripted by PhotoRobot consultants for custom functionality. Users can also script basic functions for initial experiments or simple setups. For technical documentation on configuring Wizard Steps, see the Wizard Mode Configuration Support Manual.

Access Wizards Mode

To access Wizards mode, open the Settings menu in the local app. Here, users can load Wizards via the left-hand side menu, or create a new wizard using Add Wizard in the top-right part of the interface:

how to open PhotoRobot wizard

Options to create, edit, or customize a Wizard include Wizard name, Item name, Notes, Presets, Workspace, and Wizard steps:

PhotoRobot Wizard editor user interface

Note: In order to launch a Wizard, it must contain valid Presets, all Workspace configurations, and most importantly the number and names of directory folders. Each of these will then have to match the steps defined in the Wizard for its proper operation.

Example Wizard Steps Script

For reference, the following is a generic script for initial experimentation and setup by a customer. Customers can use this code in the Steps section to test its functionality and run a basic script:

   "type": "select-item",
   "fields": [
       "name": "name"
       "name": "note",
       "optional": true
   "design": {
     "bgImage": ""
   "type": "liveview",
   "title": "Check the position",
   "note": "Check that person is in view.",
   "cameraAngle": 15
   "type": "capture-folder",
   "title": "Capture spin",
   "dirName": "spin"
   "type": "capture-folder",
   "title": "Capture stills",
   "dirName": "stills"

Launching Wizard Mode

To start a Wizard, first assign it to a project and click Save:

Assign PhotoRobot Wizard to Project

After assigning the Wizard to a project, it is possible to launch the Wizard in 2 ways:

  1. In the top right part of the interface, click More and Start wizard, or;
  2. Click on the User Account icon, and click Start wizard mode:

Start PhotoRobot Wizard
Start PhotoRobot Wizard from User Account Icon

Wizard Mode Operator Steps

On successful launch, the first screen of Wizards mode displays the Project name at the top, and the Wizard name below. Click Create to launch the Wizard:

PhotoRobot Wizard Startup Screen

After the start screen, the Wizard displays the first stage in the predefined operation steps. From this point on, the operator must complete instructions for each stage of capture, and click Next at the bottom of the Wizard interface to move onto subsequent steps:

PhotoRobot Wizard first steps

Usually, the first step will instruct the operator to configure the camera (or cameras) that will be in use. Here, the operator also checks that the product is positioned correctly and in view of the camera(s).

Subsequent steps then direct the operator according to Presets to capture given angles into a specific folder. These steps may also include instructions to photograph different product configurations, such as a car with its doors open, closed, or shot from the interior:

Photoshoot wizard stages

Further, Wizards can display notes for clearer explanation of individual stages. Notes are located on the left-hand side of the interface, below the step title:

Photoshoot wizard notes feature

In some cases, the Wizard may also instruct the operator to take photos for example with a handheld camera, and then import the images before the Next option is available.

Photoshoot Wizard Instructions

When complete with each stage, New item at the bottom of the interface completes the Wizard: 

Photoshoot Wizard import images

When finished, the user is returned to the Wizard start page. Here, they can exit the Wizard, or continue to the next item.

To exit the Wizard, click on the Account Icon in the top-right part of the interface, and click Exit wizard:

Exit PhotoRobot Wizards mode

If continuing to another item existing in the system, it is also possible to load items to capture via Wizard settings by changing the first step to “type”: “select -item”:

Change item for PhotoRobot Wizard

After configuration of “type”: “select -item”, users can then select items by entering the item name on the Wizard startup screen:

Wizard search by item name

Finally, it is also possible to enable password protection for Wizards mode, or to designate a Project that will start by default in the Wizard. Find these options on startup of CAPP by navigating to Settings, and clicking on Wizards.

The top of the menu options provide a toggle on / off to enter wizard mode automatically after starting CAPP. Below this, users can click Set password to enable password protection.

PhotoRobot Wizard Password Protection

Edit Mode Interface

On the right side of the screen, you can add any number of editing operations:

Photo editing mode overview

Some of the most common editing operations are listed at the top: crop, center, and background.

Automatic Crop

Crop - when cropping images, there are three main controls: the toggles for automatic cropping, aspect ratio, and padding (which controls how much space there is around the photographed object).

Automatic crop, aspect ratio, padding

Auto Center

Center - even though most PhotoRobot machines are equipped with lasers that help with positioning objects on the surface, most images will need additional software centering. This is especially important for 360° spins. When getting started, it is recommended to keep the “auto center” function on, as seen in the picture below:

Auto center control options

Background Removal

Background - this operation is used to adjust the background of the image, completely removing it if desired. Different results can be achieved by selecting the level method of background removal, the flood method, or freemasking.

With background removal by level, users utilize an RGB (red, green, blue) color of each pixel to remove colors above a certain threshold. This is advantageous when shooting products with a white backdrop, and for making an off-white background disappear. 

To use the flood method, you must select at least one point outside the photographed object. Experiment with the settings until you are satisfied with the results.

Freemasking requires more configuration than level or flood methods, but can be one of the quickest and most exact methods. It does however require additional configuration of your lights to create main and mask images for background removal.

Remember that whether or not CAPP will be able to remove the background depends mainly on how the scene is lit. If you are unable to find settings that work to satisfaction, reshoot the images with different light settings. 

Automated background removal tools

When you are satisfied with your edit settings, apply the parameters by clicking the “apply” button, located where previously the “start” button appeared.

Product photo background removal operation

Publishing Images

Once the progress bar reaches its end, your edits have been successfully applied to your images. If you are using CAPP without PhotoRobot Cloud services, your resulting images are stored in a folder structure on your local drive. 

If using PhotoRobot Cloud hosting, files can also be found in the PhotoRobot cloud storage. To access these, click Open in the cloud in the Photos section at the top-left part of the screen.

PhotoRobot cloud image storage

Exporting Images

To export an item from CAPP, users can export to a local disk, or export to the PhotoRobot Cloud. Item export makes it possible to define items with custom naming conventions, specify image format, resolution, and various filename template variables.

To access Item export settings, go to the Items section, and click  Export in the menu above the item list: 

Product imagery export configuration

The following window will open, allowing you to change export settings:

Change imagery export settings

Run the export process by clicking the Export button in the bottom right corner of this window.  

When the export progress bar has reached its end, you can click Open folder to access your exported images.

Access images in folder after export

Publish via Cloud

If publishing via PhotoRobot Cloud services, first open the item in the cloud. The interface displays the captured image. Click Codes & Links button:

Cloud publishing via Codes & Links button

Links & Codes for viewing and embedding

Copy the Direct link and paste it into your browser to view the image or spin. If satisfied, copy the Embedded spin HTML code. Paste this code onto your page to embed the spin for display.