v1.5.0

New Features

Update Notification System

• Automatic update checking - The app now checks GitHub releases for new versions on launch

Permissions Added

• android.permission.INTERNET - Required for GitHub API access

Installation

Download the appropriate APK for your device:

• arm64-v8a - For most modern devices (recommended)
• armeabi-v7a - For older 32-bit ARM devices
• universal - Works on all devices (larger file size)

To install:

adb install -r boox-rich-annotation-1.5.0-arm64-v8a.apk

Or transfer the APK to your device and install via file manager.

Verification

Verify the download integrity using SHA256 checksums:

shasum -a 256 -c SHA256SUMS.txt

Requirements

• Android 7.0 (API 24) or higher
• Onyx Boox e-reader device
• Internet connection for update checks (optional)

v1.4.1

Changes

Fixes

• Deduplicate properly so that the deleted/superseded annotions get excluded

Installation

Download the appropriate APK for your device:

• arm64-v8a - For most modern devices (recommended)
• armeabi-v7a - For older 32-bit ARM devices
• universal - Works on all devices (larger file size)

Verification

Verify the download integrity using SHA256 checksums:

shasum -a 256 -c SHA256SUMS.txt

v1.4.0

Release 1.4.0

Features

• Custom Round Filter - New round filter for Pebble templates to format decimal numbers

Improvements

• Template system now supports {{ value | round(2) }} for decimal formatting

Installation

Choose the APK for your device:

• arm64-v8a - Most modern Boox devices (recommended)
• armeabi-v7a - Older 32-bit devices
• universal - Works on all devices (larger size)

Verify integrity with SHA256SUMS.txt before installing.

v1.3.0

Features

• Text Export - Customizable templates using Pebble engine (default: Markdown)
• CSV Export - Spreadsheet format with all annotation data
• Preferences - Configure default export format (JSON/CSV/Text)
• Template Editor - Real-time validation for custom text export templates
• Export Timestamp - All formats include exportedAt field
• Timestamped Filenames - Format: Title_YYYYMMDD_HHMMSS_annotations.ext

Improvements

• E-ink optimized UI (larger text, pure black/white)
• Chapter-grouped default template with smart spacing
• Human-readable date formatting in templates
• Text export settings always visible

Installation

Choose the APK for your device:

• arm64-v8a - Most modern Boox devices (recommended)
• armeabi-v7a - Older 32-bit devices
• universal - Works on all devices (larger size)

Verify integrity with SHA256SUMS.txt before installing.

Template Variables

• book.title, book.authors, book.format, book.totalPages, book.exportedAt
• annotations (list): pageNumber, quote, note, chapter, style, color, createdAt

Use the date filter for timestamps: {{ annotation.createdAt | date("yyyy-MM-dd HH:mm:ss") }}

v1.2.0

Boox Rich Annotations v1.2.0

Release Date: June 15, 2026

What's New

Format Detection & Book Metadata Improvements

• Accurate Format Detection: Book format (epub, pdf, mobi, azw, azw3, djvu, etc.) is now extracted directly from the filename instead of idString
• Total Pages Support: Added totalPages field to exported JSON, parsed from the progress field in book metadata
• Better Title Display: Title now prioritizes the title field, with smart fallback to name field (with file extensions stripped)
• All Format Support: Removed format restrictions - now shows all books with annotations regardless of file type

Bug Fixes

• Missing Books Fixed: Previously, books with annotations weren't appearing because of format filtering (e.g., PDF books were excluded)
• Format Showing as "unknown": Fixed by using the name field directly instead of idString

Download

Choose the appropriate APK for your device:

• app-universal-release.apk (4.6MB) - Recommended - Works on all Android devices
• app-arm64-v8a-release.apk (4.6MB) - For modern ARM64 devices (most recent Boox models)
• app-armeabi-v7a-release.apk (4.6MB) - For older ARM devices

SHA256 Checksums

2d8f5ded7772c2a3348747b75e587d385e5003fb74c2f6efb5325c12fba380d8  app-arm64-v8a-release.apk
2d8f5ded7772c2a3348747b75e587d385e5003fb74c2f6efb5325c12fba380d8  app-armeabi-v7a-release.apk
2d8f5ded7772c2a3348747b75e587d385e5003fb74c2f6efb5325c12fba380d8  app-universal-release.apk

Requirements

• Android 7.0 (API 24) or higher
• Onyx Boox e-reader device
• Storage permission for saving exported JSON files

Installation

1. Download the appropriate APK file
2. Enable "Install from Unknown Sources" in your device settings
3. Open the APK file and follow the installation prompts
4. Grant storage permissions when requested

Upgrade Notes

This is a minor update with no breaking changes. If you're upgrading from v1.1.0 or earlier:

• All your existing books and annotations will continue to work
• Exported JSON now includes totalPages field (when available)
• Books that were previously hidden due to format filtering will now appear

Known Issues

None reported.

Credits

Developed by Meghnaad for the Onyx Boox community.

---

Previous Version: v1.1.0
Version Code: 4
Target SDK: Android 14 (API 36)

1.1.0

Boox Rich Annotations v1.1.0

Release Date: June 13, 2026

What's New

Major UI Overhaul

• Streamlined Single-Page Interface: Replaced multi-page navigation with a single-page list view with inline actions for faster workflow
• Icon-Based Actions: Save and share buttons are now icon buttons positioned at bottom-right of each book card
• Annotation Count Display: Each book card now shows the annotation count directly
• Smart Filtering: Only books with at least one annotation are displayed in the list

E-ink Display Optimizations

• Pure Black Icons: All icons (refresh, sort, search, save, share) are now pure black (#000000) for optimal e-ink visibility
• Consistent Dialog Styling: All dialogs now feature white backgrounds with black borders and properly styled buttons
• Enhanced Contrast: Larger text sizes (20sp titles, 16sp metadata) for better readability on e-ink displays

Improved Sorting

• Popup Menu Selector: Sort options (Last Read / Alphabetical) now appear in a compact popup menu instead of a dialog
• Visual Feedback: Current sort mode is indicated with a checkmark

Better UX

• Tooltips: All buttons now have descriptive tooltips on long-press
• Streamlined Export: Save button now shows a confirmation dialog with option to open the exported file
• Reading Order Sorting: Annotations are sorted by page number and character position (locationBeginInt) for true reading order

Technical Improvements

• Bulk Loading: All annotations are loaded in a single efficient query and matched to books
• Better Performance: Reduced database queries and eliminated per-book annotation fetching
• Cleaner Codebase: Removed unused BookDetailActivity and related files

Download

Choose the appropriate APK for your device:

• app-universal-release.apk (4.6MB) - Recommended - Works on all Android devices
• app-arm64-v8a-release.apk (4.6MB) - For modern ARM64 devices (most recent Boox models)
• app-armeabi-v7a-release.apk (4.6MB) - For older ARM devices

SHA256 Checksums

a47cfd63e21e3f9f04ab7d8860a6c0da108198999479f53945d7db937254721f  app-arm64-v8a-release.apk
a47cfd63e21e3f9f04ab7d8860a6c0da108198999479f53945d7db937254721f  app-armeabi-v7a-release.apk
a47cfd63e21e3f9f04ab7d8860a6c0da108198999479f53945d7db937254721f  app-universal-release.apk

Requirements

• Android 7.0 (API 24) or higher
• Onyx Boox e-reader device
• Storage permission for saving exported JSON files

Installation

1. Download the appropriate APK file
2. Enable "Install from Unknown Sources" in your device settings
3. Open the APK file and follow the installation prompts
4. Grant storage permissions when requested

Usage

1. Launch the app to see all books with annotations
2. Use the search bar to filter books by title or author
3. Use the sort button to toggle between "Last Read" and "Alphabetical" sorting
4. Tap the save icon on any book card to export annotations as JSON
5. Tap the share icon to share the JSON file via other apps

Known Issues

None reported.

Credits

Developed by Meghnaad for the Onyx Boox community.

---

Previous Version: v1.0.1
Version Code: 3
Target SDK: Android 14 (API 36)

v1.0.1

Release v1.0.1

Bug Fix Release

🐛 What's Fixed

• Sorted Annotations Export - Annotations are now properly sorted in exported JSON:
  • First by page number (ascending)
  • Then by creation time (ascending) for annotations on the same page
  • Ensures annotations appear in reading order

📦 Downloads

Choose the appropriate APK for your device:

Recommended

• BooxRichAnnotation-v1.0.1-universal.apk (4.5 MB)
  • Works on all Boox devices
  • If unsure, download this one

Architecture-Specific

• BooxRichAnnotation-v1.0.1-arm64-v8a.apk (4.5 MB)

  • For newer Boox devices (64-bit ARM)
  • Tab Ultra, Tab X, Note Air 2 Plus, Tab Mini C, etc.

• BooxRichAnnotation-v1.0.1-armeabi-v7a.apk (4.5 MB)

  • For older Boox devices (32-bit ARM)
  • Older Note, Nova, Poke models

📋 Requirements

• Android 7.0 (API 24) or higher
• Onyx Boox device with kreader app installed

🚀 Installation

1. Download the appropriate APK
2. Enable "Install from Unknown Sources" in Settings
3. Open the APK file to install
4. Launch the app

📝 Full Feature List

• 📚 Browse all your ebooks (EPUB, MOBI, AZW/AZW3)
• 🔍 Search books by title or author
• 🎨 Export rich annotations with colors and styles
• 📥 Download annotations as structured JSON
• 🔄 Real-time refresh
• ⚡ E-ink optimized theme
• 🎯 Automatic deduplication of edited annotations
• ✅ NEW: Sorted annotations in export (page → time)

🔐 Permissions

• QUERY_ALL_PACKAGES - To access Onyx content provider (Android 11+)
• WRITE_EXTERNAL_STORAGE - For file downloads (Android 9 and below only)

📄 License

MIT License - Free and open source

---

Full Changelog: v1.0.0...v1.0.1

v1.0.0

Release v1.0.0

Boox Rich Annotation - Initial Release

📦 Downloads

Choose the appropriate APK for your device:

Recommended

• BooxRichAnnotation-v1.0.0-universal.apk (4.5 MB)
  • Works on all Boox devices
  • If unsure, download this one

Architecture-Specific (Smaller size)

• BooxRichAnnotation-v1.0.0-arm64-v8a.apk (4.5 MB)

  • For newer Boox devices (64-bit ARM)
  • Tab Ultra, Tab X, Note Air 2 Plus, etc.

• BooxRichAnnotation-v1.0.0-armeabi-v7a.apk (4.5 MB)

  • For older Boox devices (32-bit ARM)
  • Older Note, Nova, Poke models

✨ Features

• 📚 Browse all your ebooks (EPUB, MOBI, AZW/AZW3)
• 🔍 Search books by title or author
• 🎨 Export rich annotations with colors and styles
• 📥 Download annotations as structured JSON
• 🔄 Real-time refresh
• ⚡ E-ink optimized theme
• 🎯 Automatic deduplication of edited annotations

📋 Requirements

• Android 7.0 (API 24) or higher
• Onyx Boox device with kreader app installed

🚀 Installation

1. Download the appropriate APK
2. Enable "Install from Unknown Sources" in Settings
3. Open the APK file to install
4. Launch the app

🎨 Annotation Styles Supported

• Highlight (filled)
• Underline (straight)
• Dashed underline
• Wavy underline
• Redact
• Mute

📝 JSON Export Format

{
  "title": "Book Title",
  "authors": "Author Name",
  "format": "epub",
  "annotations": [
    {
      "quote": "Selected text...",
      "pageNumber": 42,
      "chapter": "Chapter Name",
      "createdAt": 1781261518476,
      "color": "#a020f0",
      "style": "highlight",
      "note": "Optional note text"
    }
  ]
}

🔐 Permissions

• QUERY_ALL_PACKAGES - To access Onyx content provider (Android 11+)
• WRITE_EXTERNAL_STORAGE - For file downloads (Android 9 and below only)

📱 Tested On

• Onyx Boox Tab Mini C (Android 11)

🐛 Known Issues

None reported yet. Please open an issue if you encounter any problems.

📄 License

MIT License - Free and open source

---

Full Changelog: Initial release