Scan paper documents with your camera. Straighten, clean up, and save them as PDF. Private by design: everything runs on your device. No account, no ads, no tracking.
Download · Features · Install · How it works · Build
Your documents · automatic page detection · straightened page with filters
- 📷 Capture or import: live camera with the page outline drawn as you aim, or import photos (several at once).
- ✂️ Automatic page detection: the corners snap to the page. Drag them to fine-tune, with a magnifier for precision.
- 📐 Perspective correction: a photo taken at an angle becomes a flat, upright page.
- ✨ Filters: Magic color removes shadows and colour casts. There are also Lighten, Grayscale and B&W.
- 📚 Multi-page documents: add, reorder, re-edit, rotate and delete pages; the original photo is kept for re-cropping.
- 📄 Export: one PDF per document, or a JPG per page. On Android you can also share straight to other apps.
- 🔒 Offline and private: scans stay in local app storage. The app makes no network requests.
Get the files from the latest release.
| Platform | File | Requirements |
|---|---|---|
| Linux | DocScan-<version>-amd64.deb |
Debian, Ubuntu or derivatives, x86-64 |
| Windows | DocScan-<version>-setup-x64.exe (installer)DocScan-<version>-portable-x64.exe (no install) |
Windows 10 or 11, x64 |
| Android | DocScan-<version>.apk |
Android 10 or newer |
This command works from any folder. It downloads the package, then installs it; run it again with a newer version to update.
wget -O /tmp/DocScan.deb https://github.com/Hafij-DEU/Scan/releases/download/v0.1.2/DocScan-0.1.2-amd64.deb && sudo apt install /tmp/DocScan.debInstalling a .deb you already downloaded
Give apt the file's full path. A bare file name is looked up as a package name and fails.
sudo apt install ~/Downloads/DocScan-0.1.2-amd64.debSome download managers save to ~/Downloads/Compressed/ instead.
To uninstall: sudo apt remove docscan.
Run the installer, or start the portable exe without installing. The builds aren't code-signed yet, so SmartScreen may say "Windows protected your PC". Choose More info, then Run anyway.
Open the APK on your phone and allow installs from your browser or file manager when asked. Updates install over the previous version and keep your scans.
Verify downloads
Each release has a SHA256SUMS file for the .deb and .apk, and GitHub shows a SHA-256 digest for every file:
sha256sum -c SHA256SUMS --ignore-missingThe APK signing certificate has SHA-256 0d5accebaeb219e5012b290a87e8ad0b672f2e22f5f85d419b370abcd7d96a50.
All image processing is plain TypeScript running on the device. It has no OpenCV, no machine learning, and no server.
flowchart LR
A[Camera frame<br>or photo] --> B[Detect page]
B --> C[Adjust corners]
C --> D[Perspective<br>correction]
D --> E[Filter]
E --> F[(IndexedDB)]
F --> G[PDF / JPG]
| Step | Method | Code |
|---|---|---|
| Detect page | Otsu threshold, largest region with holes filled, convex hull, max-area quadrilateral. Each side must have a visible edge, so screenshots and flat scans keep the whole image. | detect.ts, geometry.ts |
| Perspective correction | 8-point homography with bilinear sampling, output up to 2480 px (about A4 at 300 dpi) | warp.ts |
| Filters | Divide by an estimated paper background (block bright-mean, dilated and smoothed), then a tone curve | filters.ts |
| Dependency-free PDF 1.4 writer, one JPEG per page | pdf.ts |
|
| Storage | IndexedDB stores documents and pages, keeping originals for re-editing | store.ts |
One web app (src/, Vite + TypeScript, about 30 KB of JavaScript) ships in two shells:
- Linux and Windows: Electron, packaged by electron-builder. Windows builds run on GitHub Actions.
- Android: a small Java WebView host. It serves the app from a secure origin, grants camera access, and saves or shares exports.
Requirements: Node.js 22+, pnpm 10 (corepack enable). For Android you also need JDK 17, the Android SDK (platform 35) and Gradle 8.11.
pnpm install
pnpm dev # browser preview at http://localhost:5173
pnpm start # desktop app (Electron)
pnpm build:deb # release/DocScan-<version>-amd64.deb
pnpm build:win # release/*.exe (on Windows; CI does this for releases)
pnpm build:apk # debug APK in android/app/build/outputs/apk/debug/Android build notes
build:apk runs Gradle from ~/.local/opt/gradle-8.11.1 in offline mode. Set sdk.dir in android/local.properties.
For a signed release APK, set DOCSCAN_KEYSTORE, DOCSCAN_KEYSTORE_PASSWORD, DOCSCAN_KEY_ALIAS and DOCSCAN_KEY_PASSWORD, then run gradle assembleRelease in android/.
The version comes from package.json for every platform.
Project layout
| Path | Purpose |
|---|---|
src/imaging/ |
Page detection, perspective warp, filters, image helpers |
src/screens/ |
Home, camera, crop, enhance, document and page screens |
src/ui/ |
DOM helpers, dialogs and the screen router |
src/pdf.ts, src/store.ts, src/platform.ts |
PDF writer, IndexedDB storage, Android/desktop save and share |
electron/ |
Desktop shell |
android/ |
Android WebView shell (Gradle project) |
.github/workflows/ |
Windows release build |
docs/ |
Screenshots and the design notes |
- Text recognition (OCR) and searchable PDFs
- Signatures and annotations
- ID-card mode (both sides on one page)
- Signed Windows builds
DocScan is an independent, clean-room project. Its feature set was scoped from a static analysis of CamScanner (notes); no CamScanner code or assets are used.
MIT © 2026 Hafij-BGE