Skip to content

App Features Summary

You control the OT-2 using the Opentrons App on your computer. This section highlights key features found in the Protocols, Labware, and Devices tabs of the app.

Protocols tab

The Protocols tab is selected by default when you first launch the app. It includes controls that let you import protocol files and manage saved files.

Protocols summary

The basic protocol screen displays a summary list of all the protocols stored on your computer.

Protocols tab showing uploaded protocols

Other screen elements and actions let you sort protocols, assign a protocol to a robot, and expand the protocol summary to see more information about each protocol.

Feature Description
Sort by Opens a menu that sorts protocol files. Options include:
  • Alphabetical
  • Reverse alphabetical
  • Most recent updates
  • Oldest updates
  • Flex protocols first
  • OT-2 protocols first
Import button Opens a file picker that lets you browse to and upload other saved protocols.
Three-dot (⋮) menu Opens a menu that includes these options:
  • Start setup: choose a networked Opentrons robot to run a protocol.
  • Reanalyze: runs protocol analysis on a saved or revised protocol.
  • Show in folder: opens the file location for stored protocols.
  • Delete: deletes a protocol. Tip: Use the "Show in folder" option to delete protocols in bulk.
Create or download a new protocol Links to the Protocol Library, Protocol Designer, and the Python API.

Protocol details

You can click on any listed protocol summary to see more information about the protocol.

Protocol details screen

Click the Protocols tab to return to the summary view.

Labware tab

This tab stores information about labware found in the Labware Library. You can also upload custom labware you create and store it in the app here.

Devices tab

The Devices tab lists all the discoverable Opentrons robots on a network. This means it will show you OT-2 and Flex robots, if you have different models in your lab. The app lists robots alphabetically by name.

Devices tab showing list of robots

Each summary tile provides robot information as shown in the following table.

Category Description
Connectivity Icons indicate the network connection type used by your OT-2. These are:
  • Ethernet
  • Wi-Fi
  • USB
Instruments Gray labels show the type of pipette attached to the gantry.
Modules Icons indicate which powered modules are attached to your OT-2. These include:
  • Temperature Module
  • Magnetic Module
  • Heater-Shaker
  • Thermocycler
Peripherals Other attached and powered components (e.g., built-in camera ).

Tip

If you're using a Wi-Fi connection and the OT-2 you want to use is unavailable, check your Wi-Fi settings. Your OT-2 may be on a different wireless network.

Robot details

You can click on any robot summary to see more information about a particular robot. In each section, three-dot (⋮) menus provide context-specific controls for the robot, any attached instruments and modules.

Device 3-dot menus for robot hardware controls

Context menus shown for reference. Only one can be active at a time.

Module status and controls

Use the Opentrons App to view the status of modules connected to your OT-2 and control them outside of protocols. Click Devices and then click on your OT-2 to view its robot details page. Under Instruments and Modules, there is a card for each attached module. The card shows the type of module, what USB port it is connected to, and its current status.

Temperature module details card in app

Module card for the Temperature Module.

Click the three-dot menu (⋮) on the module card to choose from a menu of commands. You can always choose About module to see the module's firmware version and serial number. (This information is very useful when contacting Opentrons Support!) The other commands depend on the type of module and its current status:

Module type Commands
Heater-Shaker
  • Set module temperature / Deactivate heater
  • Open labware latch / Close labware latch
  • Test shake / Deactivate shaker
Magnetic Module
  • Set engage height/Disengage module
Temperature Module
  • Set module temperature / Deactivate module
Thermocycler
  • Set lid temperature / Deactivate lid
  • Open lid / Close lid
  • Set block temperature / Deactivate block

Built-in camera

Every OT-2 comes equipped with a built-in 2-megapixel camera that can capture full HD still images of the deck and working area. When enabled, the camera can take pictures when running a protocol :

  • Created using the Python API and includes the capture_image method.

  • Created with Protocol Designer.

  • When the OT-2 encounters an error.

Due to limits on processing power and memory, the OT-2 cannot live-stream a protocol run.

Recent protocol runs

The robot details page also keeps records of recent protocol runs.

Recent protocol runs section

Each entry in the recent protocol runs list includes the protocol name, its timestamp, whether the run was canceled or completed, and the duration of the run. Click the disclosure triangle next to any run to show its associated labware offset data. Click the three-dot menu (⋮) for related actions:

  • View protocol run record: Show the protocol run screen as it appeared when the protocol ended (succeeded, failed, or was canceled), including all performed steps.

  • Rerun protocol now: The same as choosing Start setup on the corresponding protocol.

  • Download run log: Save to your computer a JSON file containing information about the protocol run, including all performed steps.

  • Delete protocol run record: Delete all information about this protocol run from the robot, including labware offset data. When you choose this option, it's as though the protocol run never happened.

Note

If you need to maintain a comprehensive record of all runs performed on your robot, you must use the Download run log feature to save this information to your computer.

  • Download image files: Save to your computer a .zip file containing all the images taken during a protocol run, if the camera was enabled.