Need help with RoboScan?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

198 Stars 15 Forks GNU General Public License v3.0 24 Commits 0 Opened issues


Raspberry Pi-powered analog film automatic scanner

Services available


Need anything else?

Contributors list

# 112,148
React N...
1 commit
# 73,274
1 commit
# 55,388
1 commit


This is the source code for a Lego+Raspberry Pi-powered analog film roll scanner. Watch it in action: RoboScan


You'll need these items to build RoboScan: * A digital camera with a macro lens: must be compatible with libgphoto2 with image capture and preview support. * A Raspberry Pi: you may choose a Pi 4 if your camera supports USB 3, otherwise a Pi 2 or 3 is fine. * A 28BYJ-48 Stepper Motor with ULN2003A driver: easy to find and cheap (about $6) * 3D-print an adapter to integrate the stepper motor in the legos: use the stepper mount and axis adapter provided by this project (you'll need some bolts to attach the motor to the adapter): * Adafruit White LED Backlight Module. * A LED driver such as Recom Power RCD-24-0.70/PL/B or Sparkfun FemtoBuck LED Driver. * A 50V, 47 μF capacitor * A high-power LED, such as New Energy LST1-01G03-4095-01: a 4000K white LED, with a CRI (Color Rendering Index) of 95. * Build the lego part:

Part 1: Wiring


Roboscan wiring diagram

(made using Fritzing with the help of parts from and Blomquist)

ULN2003A wiring

Put a 50V, 47 μF capacitor between the LED+ and LED - pins of the driver.

| ULN2003A Stepper Motor driver | Raspberry Pi | | ----------- | ----------- | | IN1 | GPIO 5 | | IN2 | GPIO 6 | | IN3 | GPIO 13 | | IN4 | GPIO 19 | | POWER+ | 5V power (such as the one next to the Ground) | | POWER - | Ground (such as the one next to the 5V power) |

Recom Power RCD-24-0.70/PL/B Backlight LED driver wiring

| Recom Power RCD-24-0.70/PL/B | Raspberry Pi | | ----------- | ----------- | | 1 - +Vin | 5V power (the one not already used by the stepper motor) | | 3 - PWM/ON/OFF | GPIO 18 | | 4 - GND | Ground (such as the one next to the GPIO 18) |

Alternative: Sparkfun FemtoBuck Backlight LED driver wiring

Untested - make sure to solder the jumper that can be closed with a glob of solder to double the output current from 330mA to 660mA. | Sparkfun FemtoBuck LED Driver | Raspberry Pi | | ----------- | ----------- | | V-/PGND | Ground (any remaining) | | V+/VIN | 5V power (the one not already used by the stepper motor) | | D-/DGND | Ground (such as the one next to the GPIO 18) | | D+/CTRL | GPIO 18 |

Part 2: Software installation

Prepare the Raspberry Pi

Follow Raspberry foundation documentation, such as: Tip: you can set the hostname of your Raspberry Pi to "piscanner" as it's what's used in this tutorial. You can use raspi-config for this.

Install Docker

The easiest is to use the "convenience script" as described here:

In a nutshell: ```bash curl -fsSL -o sudo sh

Add your user to the docker group

sudo groupadd docker sudo usermod -aG docker $USER ```

Install docker-compose

Full docker-compose installation instructions are available here:

On Raspbian, the easiest is to install it through Python's pip: ```bash

Install Python3 and pip

sudo apt install python3 python3-pip

Install docker-compose

sudo pip install docker-compose ```

Clone this repository on your Raspberry Pi

git clone
cd RoboScan

Start the application

Now, you will ask docker to build and start the application. This might take a while (30-120 minutes).

cd docker
docker-compose up -d --build

It will start all components and restart them at reboot.

Part 3: Using RoboScan

The camera must be connected to the Raspberry Pi via USB. It must be compatible with libgphoto2.

Connect to the web interface

Simply navigate to http://piscanner/ (adjust the hostname to your Raspberry Pi)

Optional: Google Coral TPU

You can improve the machine learning inference performance by using a Google Coral Edge TPU USB Accelerator plugged on a USB port of the Raspberry Pi. To do so, you have to change the file src/Dockerfile. Replace:

CMD ["python", "", "--destination", "/storage/share", "--archive", "/storage/archive", "--temp", "/storage/tmp"]
CMD ["python", "", "-tpu", "--destination", "/storage/share", "--archive", "/storage/archive", "--temp", "/storage/tmp"]

Optional: for developers

The easiest is to code on you PC and deploy docker containers remotely. To do so, enable remote access to the docker daemon.

# Set the DOCKERHOST variable (only once)
export DOCKER_HOST=tcp://piscanner:2376 DOCKER_TLS_VERIFY=

Then deploy as usual

cd docker

Adjust the hostname to your Raspberry Pi

docker-compose up -d --build cd ..

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.