A modern, offline-first Android Document Scanner & PDF Creator.
- Camera Scan: Auto-detects document edges (MVP: Manual capture).
- Edit: Crop and apply filters (B/W, Grayscale).
- Library: Organize and search documents.
- PDF Export: Generate A4 PDFs on device.
- Offline First: No internet required, all processing is local.
- Open Android Studio.
- Select File > Open...
- Navigate to the project directory:
/Users/shivanshkumar/Documents/Cam Scanner. - Select the folder and click Open.
- Wait for Gradle Sync: Android Studio will automatically detect the
settings.gradle.ktsandlibs.versions.toml. It will download necessary dependencies.- Note: If you see a "Gradle wrapper incomplete" warning, simply click the "Upgrade Gradle Wrapper" link or let Android Studio regenerate it.
- Select Build Variant: Ensure
debugis selected. - Connect Device:
- Connect a physical Android device via USB (Debugging enabled).
- Or create an Emulator (Camera support required).
- Run: Click the green "Run" (Play) button in the toolbar.
- "SDK Location not found": Create a
local.propertiesfile withsdk.dir=/Users/your_user/Library/Android/sdk(Android Studio does this automatically on open). - Camera Permission: The app needs Camera permission. If denied, go to App Settings to enable it manually if the dialog doesn't appear.
This project follows Clean Architecture with Multi-Module setup:
:app- UI Host:feature:*- Screens (Scan, Edit, Library):core:*- Reusable components (Data, Camera, ML, PDF)