Releases

Version policy and release history for Scanly.

Current release

Canonical source: versionCode and versionName in app/build.gradle.kts.

The version shown in Settings reads versionName via DefaultSettingsRepository.

Release highlights

Version 1.0.17 (relative to 1.0.16):

• Rebuilt page filter engine (paper-aware lighting model, eight presets, Intensity 0–150 %); Room schema 5
• Library redesign: search field, folder shelf with See all, dated document sections, dedicated search screen
• Home search bar; Home, Library and search share one field style
• Tools redesign: Scan / PDF / Utilities groups; every PDF tool is choose a file → options → done
• Full-screen PDF picker (empty scans hidden), real result preview, editable output name, Save to phone / Share
• Watermark engine rebuilt: correct on rotated pages, fitted single stamps, angle-aligned tiles, colours, presets, date
• Password can restrict editing; Merge orders files before merging; Reader adds a pages grid
• QR: scan with torch and photo import, typed results (link, UPI, Wi-Fi, contact…), five create types, history
• Clearer light theme; navigation bar strip fixed; status bar stays visible on dark camera/reader screens

The compact GitHub release description used by the in-app update dialog is available in release-notes/v1.0.17.md.

Versioning policy

• Version name — semantic-style MAJOR.MINOR.PATCH for user-facing releases.
• Version code — monotonically increasing integer required by Play Store.
• Distribution build types — githubRelease and playStoreRelease share the same version and application ID; only their update provider differs.
• Bump both together on every public release.
• Record user-visible changes in CHANGELOG.md.
• Keep VERSION.md aligned with Gradle values.

Recent releases

1.0.17 (code 17) — 2026-10-14

• Professional filter engine with Intensity; legacy presets remapped (schema 5)
• Library and Home redesign with shared search
• Tools redesign: step-based PDF tools with result preview and file naming
• Rebuilt watermark engine; password editing restriction; merge ordering; reader pages grid
• QR typed results, create types, and on-phone history
• Light theme contrast and navigation bar fixes

1.0.16 (code 16) — 2026-09-16

• Paper library/home cards and overflow actions
• Portrait document pages and document-style PDF reader
• Tools studio chrome (QR, merge, compress, password, watermark)
• Camera permission asks before Settings; OpenCV 16 KB page-size fix
• Professional page filter engine (look stays connected to the capture)
• Closed-loop filter strength (avoids overblown and underdone pages)
• Picker, live preview, and save use the same filter analysis

1.0.14 (code 14) — 2026-07-24

• Shared illustrated empty states across the app
• Multi-select add-to-folder workflow
• Refined empty-state spacing, sizing, and wording

1.0.13 (code 13) — 2026-07-18

• QR Scan and Create QR release-build crash fix
• ML Kit and CameraX startup lifecycle hardening
• Release shrinker configuration for QR barcode dependencies

1.0.11 (code 11) — 2026-07-17

• Home-screen widgets, launcher quick actions, and library cleanup
• Dedicated crop screen with AI Detect and four-point handles
• Full-screen Filters and Adjust with per-page filter adjustments
• Live cropped editor preview and two-pane large-screen editor layouts
• Tighter document detection overlays and improved filter picker controls

1.0.10 (code 10) — 2026-07-13

• Tools hub, QR code tool, and offline PDF toolkit (reader / merge / compress / password / watermark)
• Multi-model detection ladder, semantic gate, automatic selection default on, model benchmark
• Book-page isolation, stable overlays, rebuilt filters, pure black theme
• Tablet and landscape layout improvements for Tools and PDF flows

1.0.9 (code 9) — 2026-07-05

• Configurable export destinations and .scanly library backup/restore
• Advanced PDF export controls and ten enhancement filters
• Suggested duplicate-safe document and folder names
• Improved page preview, onboarding, capture layouts, and library filters
• Separate GitHub and Google Play update channels
• Refined portrait/landscape capture layouts
• Improved capture feedback (lighting, blur, obstruction, framing)
• Retake returns directly to editor after capture
• Renaming no longer replaces first-page thumbnail

1.0.8.betaq (code 8) — 2026-06-27

• Removed REQUEST_INSTALL_PACKAGES; update opens GitHub release page (superseded by Google Play in-app updates on playStoreRelease builds)

1.0.7 (code 7) — 2026-06-27

• Update dialog rate-limited to once per 6 hours

1.0.4 (code 4) — 2026-06-15

Major feature release:

• Document groups (collections)
• Gallery import (≤10 images)
• Library screen with search and sort
• Storage usage panel and clear-all-data
• Group PDF export (merged and zipped)
• Room schema v3

1.0.0 (code 1) — initial

• Offline scanning, editing, persistence, PDF/image export, settings

Full details: CHANGELOG.md

Upgrade notes

From 1.0.16 to 1.0.17 (schema 5)

• Room schema 5 via ScanlyDatabase.MIGRATION_4_5: adds scan_pages.filterIntensity (default 1, the tuned look).
• Legacy presets are remapped in scan_pages.filterPreset and documents.preferredFilterPreset: Enhanced Color → Natural, Shadow Reduction → Magic Color, Clean → Grayscale, Soft Black & White and Receipt → Faded Text.
• Existing pages keep their stored adjustments and get the new engine the next time they are captured or saved from the editor.
• .scanly backups written after this change include filterIntensity; older archives restore with 1.
• No manual steps required.

From 1.0.14 to 1.0.16

• No Room schema change.
• Existing pages keep their stored preset and adjustments. The new filter engine is used the next time a page is captured or saved from the editor.
• Filter picker chips, live preview, and saved JPEGs now share one analysis profile.
• Library, document, PDF reader, and Tools screens are visual-only; search, sort, export, and PDF processing semantics are unchanged.
• Play Store 16 KB page-size support requires the OpenCV 5.0.0.1 native libraries bundled in this build.

Room schema 3 → 4 (v1.0.11)

• Adds per-page filter adjustment columns: filterBrightness, filterContrast, filterSaturation, filterSharpness (defaults 0).
• Applied by ScanlyDatabase.MIGRATION_3_4 registered in DatabaseModule.
• No manual steps; existing pages keep default (identity) adjustments.
• .scanly backups written after this change include the four floats; older archives restore with defaults.

From 1.0.10 to 1.0.11

• Existing libraries migrate automatically through MIGRATION_3_4.
• Per-page filter adjustments default to identity values for existing pages.
• Older .scanly archives restore with default adjustment values; new archives include the four adjustment fields.

From 1.0.9 to 1.0.10

• Model labels are Lite / Standard / High / Accurate; storage keys keep the same underlying weights.
• Automatic model selection defaults to on when unset; existing explicit off preference is preserved.
• The public 1.0.10 tag used Room schema 3; v1.0.11 adds schema 4 for filter adjustments.

From 1.0.0 to current

• Room migrates automatically along 1→2→3→4→5 (filter preset, document groups, filter adjustments, then filter intensity and the legacy preset remap).
• Existing documents remain; they appear ungrouped until moved into a collection.
• Clear all data (added in 1.0.4) is destructive and cannot be undone.
• Completed external .scanly backups survive clear-all-data.
• No manual migration steps required.

See VERSION.md for extended upgrade guidance.

Where version is defined