# ScanDot (faizfahmi77/ScanDot)

> 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.

- GitHub: https://github.com/faizfahmi77/ScanDot
- GitHub.Locker page: https://github.locker/faizfahmi77/ScanDot
- Stars: 544
- Language: Kotlin
- License: MIT
- Last push: 2026-11-13

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**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.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/faizfahmi77/ScanDot/blob/main/README.md

# ScanDot

[![CI](https://github.com/faizfahmi77/ScanDot/actions/workflows/ci.yml/badge.svg)](https://github.com/faizfahmi77/ScanDot/actions/workflows/ci.yml)

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

- Capture, save and reopen point clouds on devices that support ARCore Depth.
- Rotate, pan and zoom scans in the viewer. An optional full-depth mode interpolates missing depth and can distort surfaces.
- Prepare video frames and run a sparse or dense COLMAP reconstruction on a workstation.

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](https://github.com/faizfahmi77/ScanDot/releases/tag/v0.3.0-preview.1). 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.

```sh
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:

```sh
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:

```sh
python -m unittest discover -s tests -v
```

## Project structure

```text
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](https://github.com/faizfahmi77/ScanDot/wiki) for installation, capture and troubleshooting guides. See [CONTRIBUTING.md](CONTRIBUTING.md) for development checks and [LICENSE](LICENSE) for reuse terms.

