Skip to content

Install OpenPnP

OpenPnP is open-source software designed to control pick and place machines. It supports a wide range of machines, with many features found in high-end commercial software. You can find out more about it here.

OpenPnP Logo

OpenPnP is designed to run on many different kinds of host computers. However, USB drivers and internal USB hub bandwidth can vary between computers. For reliable connectivity and exposure control with the LumenPnP cameras, we recommend using a Lenovo Thinkpad (any model should be fine) running Ubuntu 20.04 LTS or Ubuntu 22.04 LTS.

MacOS No Longer Compatible

OpenPnP no longer supports MacOS, and we have found the vurrent release for Mac to be unusable. If you are a Mac user, you'll need to switch to a supported OS or use the older version of OpenPnP 2023-04-05 version.



Download and Install OpenPnP

OpenPnP has recently started creating stable releases. We are now supporting OpenPnP's latest main release.

Use Linux if possible

We highly recommend using Ubuntu Linux as the OS for running OpenPnP due to how well it handles communication with the cameras.

Linux (Ubuntu Install Guide)

  1. Download and install OpenPnP for Linux.

    Linux Users

    Linux requires two quick configuration steps to allow OpenPnP to run:

    1. For OpenPnP to communicate to the machine, the user must be added to the dialout group. This can be done by entering sudo adduser [USERNAME] dialout (where [USERNAME] is the user you're logged in as) into terminal and restarting the computer.
    2. OpenPnP requires that Java is installed. This can easily be done by entering sudo apt-get install openjdk-17-jdk into terminal.

    Please note that if Java is not installed, OpenPnP will fail silently when you attempt to start it by clicking on the icon.

  2. Launch OpenPnP and make sure it loads fully. Doing this will ensure that OpenPnP creates a configuration folder on your computer, which we'll need in the next step.

  3. OpenPnP might prompt you to download a new version. Click Cancel and then Exit to this prompt.

  4. Completely shut down the OpenPnP software.

  1. Download and install OpenPnP for Windows.

  2. Launch OpenPnP and make sure it loads fully. Doing this will ensure that OpenPnP creates a configuration folder on your computer, which we'll need in the next step.

  3. OpenPnP might prompt you to download a new version. Click Cancel and then Exit to this prompt.

  4. Completely shut down the OpenPnP software.

Mac Users

MacOS is no longer supported, nor functional with OpenPnP.

Until further development is done, MacOS is forced to use the old version of OpenPnP.

Next Step

LumenPnP V4 Users

Import V4 config files

LumenPnP V3 Users

Import V3 config files