Skip to content
Elegant & low-cost 3D printed 3D scanning system
Python C++ C
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


SwagScanner is a device that can scan your small/medium-sized objects into the virtual world. The system is designed and built from the ground up. I designed the software pipeline to be extensible, robust, and fast. SwagScanner is compatible with any depth camera--just verify its minimum scanning distance and acquire the correct mounting hardware and API and you're good to go. You can find more information about the design process and challenges on my website.

Getting Started

These instructions will guide you through the process of setting up SwagScanner on your local machine. Complete BOM for the hardware coming soon.


Currently MacOS and Linux are the only supported platforms due to non-universal Bluetooth low-energy libraries. The setup process is kind of painful, but I have painstakingly found good, working solutions that you can easily follow along.

# Installing pyrealsense2
$ git clone
$ cd librealsense
$ mkdir build
$ cd build
$ cmake ../ -DBUILD_PYTHON_BINDINGS=bool:true
$ make -j4
$ sudo make install
$ export PYTHONPATH=$PYTHONPATH:/usr/local/lib or add that to your .bashrc


Let's setup your Swag Scanner environment

# Installing basic requirements

$ git clone
$ cd swag-scanner
$ virtualenv venv
$ source venv/bin/activate
$ (venv) pip install -r requirements.txt
$ (venv) pip install -e .
# Installing pcl and python-pcl
# cd to some random folder

$ git clone 
$ mkdir build
$ cd build
$ cmake .. 
$ make
$ sudo make install

# Now we can install python-pcl
# cd to some random folder and have your virtual environment activated

$ (venv) git clone
$ (venv) cd python-pcl
# go into, change line 710 to the version of vtk that's installed in your system, and change all instances of 'c++11' to 'c++14'
$ (venv) sudo python clean
$ (venv) sudo make clean
$ (venv) sudo make all
$ (venv) sudo python install
# Installing Adafruit's bluetooth library
# cd to some random folder

$ (venv) git clone
$ (venv) cd Adafruit_Python_BluefruitLE
$ (venv) python install



This project is licensed under the MIT License

You can’t perform that action at this time.