Skip to content

OpenScan-org/OpenScan3

Repository files navigation

OpenScan3

About The Project

OpenScan3 is a firmware for controlling OpenScan devices, a family of open source and open hardware devices, designed to make 3d scanning with photogrammetry accessible to everyone.

The goal of OpenScan3 is providing a hackable and extensible firmware for common OpenScan devices and a starting point for custom photogrammetry rigs.

OpenScan3 is maintained by OpenScan.eu.

OpenScan3 is under development and is not ready for production!

(back to top)

Getting Started

There are two ways to get started on a Raspberry Pi: flash a ready-made image or build a custom one.

Install OpenScan Image (Recommended)

Download the image from here: https://openscan.eu/pages/resources-downloads

Choose the image according to your camera variant:

  • Arducam IMX519
  • Arducam Hawkeye

Warning: Choosing the wrong image may result in permanent damage to your camera!

Flash the image with Raspberry Pi Imager or a similar tool.

Default Hostname: openscan3-alpha (or openscan3-alpha.local if mDNS is enabled)

UI (Webfrontend): http://openscan3-alpha/ or http://openscan3-alpha.local/

API documentation: http://openscan3-alpha/api/latest/docs.

Build OpenScan Image from Source

You can also use OpenScan3 Pi Image Builder based on pi-gen to build the image from source or customize it.

(back to top)

Development

See docs/DEVELOP.md for development setup, first steps, and architectural overview.

(back to top)

Roadmap

Beta (February 2026)

  • WebSockets for tasks, device state, and scan progress
  • OS/device services: Samba, USB, disk monitoring; camera-assisted Wi‑Fi/setup
  • Reliability: improved handling for Arducam Hawkeye 64MP memory issues
  • Frontend improvements (OpenScan3-client)

Release (May 2026)

  • Turntable Mode as a ScanTask
  • Enhanced hardware support
    • grblHAL
    • More Hardware controllers: displays, fans, buttons
    • Camera & capture: DSLR focus motor; broader camera support (PiCamera, DSLR via gphoto2, smartphones, external GPIO)
  • Project export: Metashape, RealityCapture, 3DF Zephyr, Meshroom
  • Automation: rsync-based project sync; new task features (auto-config via photo, background removal, drop detection)

Future

  • Further extend hardware support and hackability to use as base for photogrammetry rigs

For details and up-to-date status, see GitHub issues and check out the Discord channel.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. Pull requests, issues, and feature requests are welcome.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GPL-3.0 license. See LICENSE for more information.

(back to top)

Contact

Join the OpenScan Discord Server to get in touch with the OpenScan community!

Or write an email to info@openscan.eu

(back to top)

About

Firmware for controlling OpenScan devices.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •