ScanDot README

The project's README from github.com/faizfahmi77/ScanDot. As one markdown file: README.md.

ScanDot

CI

ScanDot is an experimental Android app for capturing and viewing 3D point clouds on a supported phone. It combines ARCore camera tracking and depth estimates, saves scans locally, and provides an interactive viewer.

The repository also contains a separate video photogrammetry pipeline that runs on a workstation using FFmpeg and COLMAP. The Android app does not reconstruct ordinary video with photogrammetry on the phone.

Current status

This is an early prototype. Results can contain gaps, drift and noise; they are not textured meshes or validated measurements. Reflective, transparent and textureless subjects are difficult. Capture quality and device compatibility need further testing.

Try the preview

Download the preview APK. The release notes describe compatibility and signing limitations.

Build the Android app

You need JDK 17, Android SDK 36, and an Android device with ARCore Depth support. Camera permission is required; Google Play Services for AR may require installation or an update.

cd android-app
./gradlew assembleDebug lintDebug testDebugUnitTest

On Windows, use gradlew.bat in place of ./gradlew. The debug APK is written to android-app/app/build/outputs/apk/debug/app-debug.apk. Install it as an update to preserve existing app data.

In the app, name the scan, tap Start scan, and move slowly around the subject in good light. Save it, then open it from Results. Scans are stored in the app's private storage; uninstalling the app removes them.

Workstation video pipeline

The benchmark requires Python 3.12 or newer, FFmpeg, FFprobe and a compatible COLMAP installation. Dense reconstruction requires a compatible COLMAP configuration. From the repository root:

python -m processing.benchmark prepare "path/to/input.mp4" --output "path/to/new-run" --fps 5
python -m processing.benchmark reconstruct "path/to/new-run" --colmap "path/to/colmap" --dense

The output directory must not already exist. Omit --dense for a sparse-only run. See the subcommand --help output for options. A successful run does not establish complete or accurate geometry.

The Python tests use the standard library:

python -m unittest discover -s tests -v

Project structure

android-app/  Android capture, local storage and point-cloud viewer
processing/   Video preparation and COLMAP orchestration
tests/        Python tests with synthetic fixtures
tools/        Workstation utilities

CI runs the Android build, lint and JVM tests, plus the Python unit tests. It does not exercise a camera, ARCore tracking, GPU reconstruction or measurement accuracy.

See the wiki for installation, capture and troubleshooting guides. See CONTRIBUTING.md for development checks and LICENSE for reuse terms.

ScanDot (faizfahmi77/ScanDot)

Searching Database…

What is this?An experimental Android app that captures 3D point clouds on a supported phone, saves them locally, and lets you view them in an interactive viewer.
Is it just a phone app, or also a desktop tool?Mainly a phone app. The repo also has a separate Python video pipeline that runs on a workstation with FFmpeg and COLMAP, but the phone app does not do photogrammetry on video.
How do I try it without building anything?Download the preview APK and install it. The release notes cover compatibility and signing limitations.
Can I use the scans to measure things?No. Results can have gaps, drift and noise. They are not textured meshes or validated measurements, and reflective, transparent or textureless subjects are hard to capture.
Which phones are supported?Only phones that support ARCore Depth can capture and reopen scans. Google Play Services for AR may need to be installed or updated, and the app needs camera permission.
Where do my scans go?They are saved in the app's private storage on the phone. Uninstalling the app deletes them.
What does full-depth mode do?It interpolates missing depth to fill gaps in a scan, but it can distort surfaces, so the README presents it as an optional mode.
Can I make a 3D model from ordinary phone video?Not on the phone. A separate workstation pipeline extracts frames with FFmpeg and runs sparse or dense COLMAP reconstruction, but the README says a successful run does not establish complete or accurate geometry.
What can I do with a saved scan in the viewer?You can rotate, pan and zoom it, and reopen it later from Results.
What do the automated checks cover?CI runs the Android build, lint, JVM tests and Python unit tests. It does not test the camera, ARCore tracking, GPU reconstruction or measurement accuracy.
Size
0.1 MB
Stars
544
Updated
CommitNov 13
Age
5d
Commits · 90 Days