release: version 0.9.99 (#3190)

Also add some missing button labels for screen readers

.dockerignore

@@ -0,0 +1,33 @@
+# Dependencies
+node_modules
+**/node_modules
+
+# Rust build artifacts
+target
+**/target
+
+# Git
+.git
+.gitignore
+
+# Build outputs
+dist
+**/dist
+.next
+**/.next
+out
+**/out
+
+# IDE
+.idea
+.vscode
+*.swp
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: ['readest']
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/feature-request.md

@@ -7,13 +7,17 @@ assignees: ''
 ---
 
 **Does your feature request involve difficulty for you to complete a task? Please describe.**
-A clear and concise description of what the problem is. Ex. I think it takes too many steps to [...]
+
+> A clear and concise description of what the problem is. Ex. I think it takes too many steps to [...]
 
 **Describe the solution you'd like**
-A clear and concise description of what you'd like to happen.
+
+> A clear and concise description of what you'd like to happen.
 
 **Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+
+> A clear and concise description of any alternative solutions or features you've considered.
 
 **Additional context**
-Add any additional context or screenshots about the feature request here.
+
+> Add any additional context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/report-bug.md

@@ -11,22 +11,16 @@ assignees: ''
 A clear and concise description of what the current behavior is.
 Please also add **screenshots** of the existing application.
 
-**Example:**
-
-```
-In DarkMode, when scrollbar are displayed (for example on Companies page, with enough companies in the list), we see a blank square in the bottom right corner
-[screenshot]
-```
+> **Example:**
+> In DarkMode, when scrollbar are displayed (for example on Companies page, with enough companies in the list), we see a blank square in the bottom right corner
+> [screenshot]
 
 ## Expected behavior
 
 A clear and concise description of what the expected behavior is.
 
-**Example:**
-
-```
-The blank square should be transparent (invisible)
-```
+> **Example:**
+> The blank square should be transparent (invisible)
 
 ## Technical inputs
 
@@ -34,11 +28,8 @@ Operating System:
 
 Readest Version:
 
-**Example:**
-
-```
-Operating System: macOS 14.3.1
-Readest Version: 0.9.0
-We are displaying custom scrollbars that disappear when the user is not scrolling. See ScrollWrapper.
-Probably fixable with CSS
-```
+> **Example:**
+> Operating System: Android 14 (WebView 135.0)
+> Readest Version: 0.9.0
+> We are displaying custom scrollbars that disappear when the user is not scrolling. See ScrollWrapper.
+> Probably fixable with CSS

.github/dependabot.yml

@@ -8,6 +8,6 @@ updates:
     groups:
       github-actions:
         patterns:
-          - "*"  # Group all Actions updates into a single larger pull request
+          - '*' # Group all Actions updates into a single larger pull request
     schedule:
       interval: weekly

.github/workflows/pull-request.yml

@@ -11,7 +11,7 @@ jobs:
     env:
       RUSTFLAGS: '-C target-cpu=skylake'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           submodules: 'true'
       - name: Install minimal stable with clippy and rustfmt
@@ -19,6 +19,7 @@ jobs:
         with:
           toolchain: stable
           override: true
+          components: rustfmt, clippy
       - name: Install system dependencies
         run: |
           sudo apt-get update
@@ -28,32 +29,65 @@ jobs:
         run: cargo fmt --check
       - name: Clippy Check
         working-directory: apps/readest-app/src-tauri
-        run: cargo clippy -- -D warnings
+        run: cargo clippy -p Readest --no-deps -- -D warnings
 
   build_web_app:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        config:
+          - platform: 'web'
+          - platform: 'tauri'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           submodules: 'true'
 
       - name: setup pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 9.15.1
 
       - name: setup node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 22
           cache: pnpm
 
+      - name: cache Next.js build
+        uses: actions/cache@v5
+        with:
+          path: apps/readest-app/.next/cache
+          key: nextjs-${{ matrix.config.platform }}-${{ github.sha }}-${{ hashFiles('pnpm-lock.yaml') }}
+          restore-keys: |
+            nextjs-${{ matrix.config.platform }}-${{ github.sha }}-
+            nextjs-${{ matrix.config.platform }}-
+
       - name: install Dependencies
         working-directory: apps/readest-app
         run: |
-          pnpm install && pnpm setup-pdfjs
+          pnpm install && pnpm setup-vendors
 
-      - name: build the web App
+      - name: run format check
+        run: |
+          pnpm format:check || (pnpm format && git diff && exit 1)
+
+      - name: run tests
         working-directory: apps/readest-app
         run: |
-          pnpm build-web
+          pnpm test -- --watch=false
+
+      - name: run lint
+        working-directory: apps/readest-app
+        run: |
+          pnpm lint
+
+      - name: build the web App
+        if: matrix.config.platform == 'web'
+        working-directory: apps/readest-app
+        run: |
+          pnpm build-web && pnpm check:all
+
+      - name: build the Tauri App
+        if: matrix.config.platform == 'tauri'
+        working-directory: apps/readest-app
+        run: |
+          pnpm build && pnpm check:all

.github/workflows/release.yml

@@ -17,14 +17,14 @@ jobs:
       release_version: ${{ steps.get-release-notes.outputs.release_version }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: setup node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
       - name: get version
         run: echo "PACKAGE_VERSION=$(node -p "require('./apps/readest-app/package.json').version")" >> $GITHUB_ENV
       - name: get release
         id: get-release
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const { data } = await github.rest.repos.getLatestRelease({
@@ -35,7 +35,7 @@ jobs:
             core.setOutput('release_tag', data.tag_name);
       - name: get release notes
         id: get-release-notes
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const fs = require('fs');
@@ -48,6 +48,63 @@ jobs:
             core.setOutput('release_version', version);
             core.setOutput('release_note', releaseNote);
 
+  update-release:
+    permissions:
+      contents: write
+    runs-on: ubuntu-latest
+    needs: get-release
+
+    steps:
+      - name: update release
+        id: update-release
+        uses: actions/github-script@v8
+        env:
+          release_id: ${{ needs.get-release.outputs.release_id }}
+          release_tag: ${{ needs.get-release.outputs.release_tag }}
+          release_note: ${{ needs.get-release.outputs.release_note }}
+        with:
+          script: |
+            const { data } = await github.rest.repos.generateReleaseNotes({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag_name: process.env.release_tag,
+            })
+            const notes = process.env.release_note.split(/\d+\.\s/).filter(Boolean);
+            const formattedNotes = notes.map(note => `* ${note.trim()}`).join("\n");
+            const body = `## Release Highlight\n${formattedNotes}\n\n${data.body}`;
+            github.rest.repos.updateRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              release_id: process.env.release_id,
+              body: body,
+              draft: false,
+              prerelease: false
+            })
+
+  build-koreader-plugin:
+    needs: get-release
+    permissions:
+      contents: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: create KOReader plugin zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          version=${{ needs.get-release.outputs.release_version }}
+          plugin_zip="Readest-${version}-1.koplugin.zip"
+          meta_file="apps/readest.koplugin/_meta.lua"
+          perl -i -pe "s/^}/    version = \"${version}\",\n}/" "${meta_file}"
+
+          cd apps
+          zip -r ../${plugin_zip} readest.koplugin
+          cd ..
+
+          echo "Uploading ${plugin_zip} to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} ${plugin_zip} --clobber
+
   build-tauri:
     needs: get-release
     permissions:
@@ -56,49 +113,75 @@ jobs:
       fail-fast: false
       matrix:
         config:
+          - os: ubuntu-latest
+            release: android
+            rust_target: aarch64-linux-android,armv7-linux-androideabi,i686-linux-android,x86_64-linux-android
           - os: ubuntu-22.04
+            release: linux
             arch: x86_64
             rust_target: x86_64-unknown-linux-gnu
           - os: ubuntu-22.04-arm
+            release: linux
             arch: aarch64
             rust_target: aarch64-unknown-linux-gnu
+          - os: ubuntu-22.04-arm
+            release: linux
+            arch: armhf
+            rust_target: arm-unknown-linux-gnueabihf
+            args: '--target arm-unknown-linux-gnueabihf --bundles deb'
           - os: macos-latest
+            release: macos
             arch: aarch64
             rust_target: x86_64-apple-darwin,aarch64-apple-darwin
             args: '--target universal-apple-darwin'
           - os: windows-latest
+            release: windows
             arch: x86_64
             rust_target: x86_64-pc-windows-msvc
-            args: '--target x86_64-pc-windows-msvc'
+            args: '--target x86_64-pc-windows-msvc --bundles nsis'
           - os: windows-latest
+            release: windows
             arch: aarch64
             rust_target: aarch64-pc-windows-msvc
             args: '--target aarch64-pc-windows-msvc --bundles nsis'
 
     runs-on: ${{ matrix.config.os }}
-    timeout-minutes: 30
+    timeout-minutes: 60
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: initialize git submodules
         run: git submodule update --init --recursive
 
       - name: setup pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 9.14.4
 
       - name: setup node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 22
           cache: pnpm
 
+      - name: setup Java (for Android build only)
+        if: matrix.config.release == 'android'
+        uses: actions/setup-java@v5
+        with:
+          distribution: 'zulu'
+          java-version: '17'
+
+      - name: setup Android SDK (for Android build only)
+        if: matrix.config.release == 'android'
+        uses: android-actions/setup-android@v3
+
+      - name: install NDK (for Android build only)
+        if: matrix.config.release == 'android'
+        run: sdkmanager "ndk;28.2.13676358"
+
       - name: install dependencies
         run: pnpm install
 
-      - name: copy pdfjs-dist to public directory
-        run: pnpm --filter @readest/readest-app setup-pdfjs
+      - name: copy pdfjs-dist and simplecc-dist to public directory
+        run: pnpm --filter @readest/readest-app setup-vendors
 
       - name: install Rust stable
         uses: dtolnay/rust-toolchain@stable
@@ -107,7 +190,24 @@ jobs:
 
       - uses: Swatinem/rust-cache@v2
         with:
-          key: ${{ matrix.config.os }}-cargo-${{ hashFiles('Cargo.lock') }}
+          key: ${{ matrix.config.os }}-${{ matrix.config.release }}-${{ matrix.config.arch }}-cargo
+
+      - name: install dependencies (ubuntu only)
+        if: contains(matrix.config.os, 'ubuntu') && matrix.config.release != 'android' && matrix.config.arch != 'armhf'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y pkg-config libfontconfig-dev libgtk-3-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf xdg-utils
+
+      - name: install dependencies (ubuntu only - armhf specific)
+        if: contains(matrix.config.os, 'ubuntu') && matrix.config.arch == 'armhf'
+        run: |
+          sudo dpkg --add-architecture armhf
+          sudo apt-get update
+          sudo apt-get install -y pkg-config libfontconfig-dev:armhf libgtk-3-dev:armhf libwebkit2gtk-4.1-dev:armhf libappindicator3-dev:armhf librsvg2-dev:armhf gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf
+          echo 'PKG_CONFIG_ALLOW_CROSS=1' >> $GITHUB_ENV
+          echo 'PKG_CONFIG_PATH=/usr/lib/arm-linux-gnueabihf/pkgconfig:/usr/share/pkgconfig' >> $GITHUB_ENV
+          echo 'PKG_CONFIG_SYSROOT_DIR=/usr/arm-linux-gnueabihf' >> $GITHUB_ENV
+          echo 'CARGO_TARGET_ARM_UNKNOWN_LINUX_GNUEABIHF_LINKER=arm-linux-gnueabihf-gcc' >> $GITHUB_ENV
 
       - name: create .env.local file for Next.js
         run: |
@@ -116,19 +216,83 @@ jobs:
           echo "NEXT_PUBLIC_SUPABASE_URL=${{ secrets.NEXT_PUBLIC_SUPABASE_URL }}" >> .env.local
           echo "NEXT_PUBLIC_SUPABASE_ANON_KEY=${{ secrets.NEXT_PUBLIC_SUPABASE_ANON_KEY }}" >> .env.local
           echo "NEXT_PUBLIC_APP_PLATFORM=tauri" >> .env.local
+          cp .env.local apps/readest-app/.env.local
 
-      - name: copy .env.local to apps/readest-app
-        run: cp .env.local apps/readest-app/.env.local
-
-      - name: install dependencies (ubuntu only)
-        if: contains(matrix.config.os, 'ubuntu')
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y pkg-config libfontconfig-dev libgtk-3-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf xdg-utils
-
-      - uses: tauri-apps/tauri-action@v0
+      - name: build and upload Android apks
+        if: matrix.config.release == 'android'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NDK_HOME: ${{ env.ANDROID_HOME }}/ndk/28.2.13676358
+          TAURI_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+          TAURI_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+        run: |
+          cd apps/readest-app/
+          rm -rf src-tauri/gen/android
+          pnpm tauri android init
+          pnpm tauri icon ../../data/icons/readest-book.png
+          git checkout .
+
+          pushd src-tauri/gen/android
+          echo "keyAlias=${{ secrets.ANDROID_KEY_ALIAS }}" > keystore.properties
+          echo "password=${{ secrets.ANDROID_KEY_PASSWORD }}" >> keystore.properties
+          base64 -d <<< "${{ secrets.ANDROID_KEY_BASE64 }}" > $RUNNER_TEMP/keystore.jks
+          echo "storeFile=$RUNNER_TEMP/keystore.jks" >> keystore.properties
+
+          popd
+          version=${{ needs.get-release.outputs.release_version }}
+          apk_path=src-tauri/gen/android/app/build/outputs/apk/universal/release
+          universial_apk=Readest_${version}_universal.apk
+          arm64_apk=Readest_${version}_arm64.apk
+          pnpm tauri android build
+          cp ${apk_path}/app-universal-release.apk $universial_apk
+          pnpm tauri android build -t aarch64
+          cp ${apk_path}/app-universal-release.apk $arm64_apk
+
+          echo "Uploading $universial_apk to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} $universial_apk --clobber
+          echo "Uploading $arm64_apk to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} $arm64_apk --clobber
+          echo "Uploading signatures to GitHub release"
+          pnpm tauri signer sign $universial_apk
+          pnpm tauri signer sign $arm64_apk
+          gh release upload ${{ needs.get-release.outputs.release_tag }} $universial_apk.sig --clobber
+          gh release upload ${{ needs.get-release.outputs.release_tag }} $arm64_apk.sig --clobber
+
+      - name: download and update latest.json for Android release
+        if: matrix.config.release == 'android'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          cd apps/readest-app/
+          curl -sL https://github.com/readest/readest/releases/latest/download/latest.json -o latest.json
+
+          version=${{ needs.get-release.outputs.release_version }}
+          universial_apk_url="https://github.com/readest/readest/releases/download/${{ needs.get-release.outputs.release_tag }}/Readest_${version}_universal.apk"
+          arm64_apk_url="https://github.com/readest/readest/releases/download/${{ needs.get-release.outputs.release_tag }}/Readest_${version}_arm64.apk"
+
+          universial_sig=$(cat Readest_${version}_universal.apk.sig)
+          arm64_sig=$(cat Readest_${version}_arm64.apk.sig)
+
+          jq --arg url "$universial_apk_url" \
+              --arg sig "$universial_sig" \
+              '.platforms["android-universal"] = {signature: $sig, url: $url}' latest.json > tmp.$$.json && mv tmp.$$.json latest.json
+
+          jq --arg url "$arm64_apk_url" \
+              --arg sig "$arm64_sig" \
+              '.platforms["android-arm64"] = {signature: $sig, url: $url}' latest.json > tmp.$$.json && mv tmp.$$.json latest.json
+
+          echo "Uploading updated latest.json to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} latest.json --clobber
+
+      - name: Override tauri-cli with custom AppImage format (Linux)
+        if: matrix.config.release == 'linux'
+        run: cargo install tauri-cli --git https://github.com/tauri-apps/tauri --branch feat/truly-portable-appimage --force
+
+      - uses: tauri-apps/tauri-action@v0
+        if: matrix.config.release != 'android'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAURI_BUNDLER_NEW_APPIMAGE_FORMAT: 'true'
           TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
           TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
           APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
@@ -144,12 +308,29 @@ jobs:
           releaseBody: ${{ needs.get-release.outputs.release_note }}
           args: ${{ matrix.config.args || '' }}
 
-      - name: upload portable binaries (Windows only)
+      - name: upload release notes to GitHub release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Uploading release notes to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} apps/readest-app/release-notes.json --clobber
+
+      - name: build and upload portable binaries (Windows only)
         if: matrix.config.os == 'windows-latest'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAURI_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+          TAURI_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
         shell: bash
         run: |
+          echo "Building Portable Binaries"
+          pushd apps/readest-app/
+          echo "NEXT_PUBLIC_PORTABLE_APP=true" >> .env.local
+          pnpm tauri build ${{ matrix.config.args }}
+
+          popd
           echo "Uploading Portable Binaries"
           arch=${{ matrix.config.arch }}
           version=${{ needs.get-release.outputs.release_version }}
@@ -172,35 +353,49 @@ jobs:
           echo "Uploading $bin_file to GitHub release"
           gh release upload ${{ needs.get-release.outputs.release_tag }} $bin_file --clobber
 
-  update-release:
-    permissions:
-      contents: write
-    runs-on: ubuntu-latest
-    needs: [get-release, build-tauri]
+          echo "Signing portable binary"
+          pushd apps/readest-app/
+          pnpm tauri signer sign "../../$bin_file"
+          popd
+          echo "Uploading signature to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} $bin_file.sig --clobber
 
-    steps:
-      - name: update release
-        id: update-release
-        uses: actions/github-script@v7
+      - name: download and update latest.json for Windows portable release
+        if: matrix.config.os == 'windows-latest'
         env:
-          release_id: ${{ needs.get-release.outputs.release_id }}
-          release_tag: ${{ needs.get-release.outputs.release_tag }}
-          release_note: ${{ needs.get-release.outputs.release_note }}
-        with:
-          script: |
-            const { data } = await github.rest.repos.generateReleaseNotes({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              tag_name: process.env.release_tag,
-            })
-            const notes = process.env.release_note.split(/(?:\d\.\s)/).filter(Boolean);
-            const formattedNotes = notes.map(note => `* ${note.trim()}`).join("\n");
-            const body = `## Release Highlight\n${formattedNotes}\n\n${data.body}`;
-            github.rest.repos.updateRelease({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              release_id: process.env.release_id,
-              body: body,
-              draft: false,
-              prerelease: false
-            })
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: bash
+        run: |
+          curl -sL https://github.com/readest/readest/releases/latest/download/latest.json -o latest.json
+
+          version=${{ needs.get-release.outputs.release_version }}
+          arch=${{ matrix.config.arch }}
+
+          if [ "$arch" = "x86_64" ]; then
+            bin_file="Readest_${version}_x64-portable.exe"
+            platform_key="windows-x86_64-portable"
+          elif [ "$arch" = "aarch64" ]; then
+            bin_file="Readest_${version}_arm64-portable.exe"
+            platform_key="windows-aarch64-portable"
+          else
+            echo "Unknown architecture: $arch"
+            exit 1
+          fi
+
+          portable_url="https://github.com/readest/readest/releases/download/${{ needs.get-release.outputs.release_tag }}/$bin_file"
+          portable_sig=$(cat $bin_file.sig)
+
+          jq --arg url "$portable_url" \
+              --arg sig "$portable_sig" \
+              --arg key "$platform_key" \
+              '.platforms[$key] = {signature: $sig, url: $url}' latest.json > tmp.$$.json && mv tmp.$$.json latest.json
+
+          echo "Uploading updated latest.json to GitHub release"
+          gh release upload ${{ needs.get-release.outputs.release_tag }} latest.json --clobber
+
+  upload-to-r2:
+    needs: [get-release, build-tauri]
+    uses: ./.github/workflows/upload-to-r2.yml
+    with:
+      tag: ${{ needs.get-release.outputs.release_tag }}
+    secrets: inherit

.github/workflows/retry-workflow.yml

@@ -0,0 +1,18 @@
+name: Retry workflow
+
+on:
+  workflow_dispatch:
+    inputs:
+      run_id:
+        required: true
+jobs:
+  rerun:
+    runs-on: ubuntu-latest
+    steps:
+      - name: rerun ${{ inputs.run_id }}
+        env:
+          GH_REPO: ${{ github.repository }}
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh run watch ${{ inputs.run_id }} > /dev/null 2>&1
+          gh run rerun ${{ inputs.run_id }} --failed

.github/workflows/upload-to-r2.yml

@@ -0,0 +1,77 @@
+name: Upload Release Assets to R2
+
+on:
+  workflow_call:
+    inputs:
+      tag:
+        required: true
+        type: string
+
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Release tag name (e.g., v1.2.3)'
+        required: true
+        type: string
+
+jobs:
+  upload-to-r2:
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+    strategy:
+      fail-fast: false
+    env:
+      RELEASE_R2_BUCKET: readest-releases
+      RELEASE_R2_ACCOUNT_ID: ${{ secrets.RELEASE_R2_ACCOUNT_ID }}
+      RELEASE_R2_ACCESS_KEY_ID: ${{ secrets.RELEASE_R2_ACCESS_KEY_ID }}
+      RELEASE_R2_SECRET_ACCESS_KEY: ${{ secrets.RELEASE_R2_SECRET_ACCESS_KEY }}
+
+    steps:
+      - name: Download release assets
+        run: |
+          gh release download "${{ inputs.tag }}" --repo readest/readest --dir ./release-assets
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install rclone
+        run: curl https://rclone.org/install.sh | sudo bash
+
+      - name: Configure rclone
+        run: |
+          mkdir -p ~/.config/rclone
+          cat > ~/.config/rclone/rclone.conf <<EOF
+          [r2]
+          type = s3
+          provider = Cloudflare
+          access_key_id = $RELEASE_R2_ACCESS_KEY_ID
+          secret_access_key = $RELEASE_R2_SECRET_ACCESS_KEY
+          endpoint = https://${RELEASE_R2_ACCOUNT_ID}.r2.cloudflarestorage.com
+          EOF
+
+      - name: Modify latest.json download URLs
+        run: |
+          GITHUB_BASE_URL="https://github.com/readest/readest/releases/download"
+          READEST_BASE_URL="https://download.readest.com/releases"
+          sed -i "s#${GITHUB_BASE_URL}#${READEST_BASE_URL}#g" ./release-assets/latest.json
+
+      - name: Upload to R2
+        run: |
+          mkdir releases
+          mv ./release-assets/latest.json releases
+          mv ./release-assets/release-notes.json releases
+          rclone copy ./release-assets r2:${RELEASE_R2_BUCKET}/releases/${{ inputs.tag }}/
+          rclone copy ./releases r2:${RELEASE_R2_BUCKET}/releases/
+
+      - name: Upload successful
+        if: success()
+        run: echo "Upload completed successfully"
+
+  retry-on-failure:
+    if: failure() && fromJSON(github.run_attempt) < 3
+    needs: [upload-to-r2]
+    runs-on: ubuntu-latest
+    steps:
+      - env:
+          GH_REPO: ${{ github.repository }}
+          GH_TOKEN: ${{ github.token }}
+        run: gh workflow run retry-workflow.yml -F run_id=${{ github.run_id }}

.github/workflows/vercel-merge.yml

@@ -11,7 +11,7 @@ jobs:
   build_and_deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           submodules: 'true'
       - uses: amondnet/vercel-action@v25

.gitignore

@@ -38,3 +38,11 @@ next-env.d.ts
 
 # Rust build
 target
+
+fastlane/report.xml
+
+*.koplugin.zip
+
+# nix
+result*
+.playwright-mcp/

.gitmodules

@@ -3,4 +3,10 @@
 	url = https://github.com/readest/foliate-js.git
 [submodule "packages/tauri"]
 	path = packages/tauri
-	url = https://github.com/tauri-apps/tauri.git
+	url = https://github.com/readest/tauri.git
+[submodule "packages/tauri-plugins"]
+	path = packages/tauri-plugins
+	url = https://github.com/readest/tauri-plugins-workspace.git
+[submodule "packages/simplecc-wasm"]
+	path = packages/simplecc-wasm
+	url = https://github.com/readest/simplecc-wasm.git

.prettierignore

@@ -1 +1,34 @@
-packages/foliate-js/
+# Dependencies
+node_modules
+pnpm-lock.yaml
+
+# Build Artifacts (Web & Rust)
+.next
+.open-next
+.build
+.tauri
+out
+build
+dist
+target
+fastlane
+.wrangler
+
+# Autogenerated Tauri files
+gen
+**/autogenerated
+**/schemas
+
+# Submodules (External Repos)
+packages
+
+# Vendored Assets (Generated/External Code)
+apps/readest-app/public/*.js
+apps/readest-app/public/vendor
+
+# Environment & Editor
+.env
+.env.*
+.vscode
+.idea
+*.log

.prettierrc.json

@@ -5,5 +5,6 @@
   "tabWidth": 2,
   "singleQuote": true,
   "jsxSingleQuote": true,
+  "endOfLine": "lf",
   "plugins": ["prettier-plugin-tailwindcss"]
 }

.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "ms-vscode.vscode-typescript-next",
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "rust-lang.rust-analyzer"
+  ]
+}

.vscode/settings.json

@@ -4,4 +4,28 @@
     "packages/tauri/Cargo.toml",
     "apps/readest-app/src-tauri/Cargo.toml"
   ],
-}
+  // "editor.formatOnSave": true, // uncomment to add format on save
+  "typescript.inlayHints.parameterNames.enabled": "all",
+  "typescript.inlayHints.variableTypes.enabled": true,
+  "typescript.inlayHints.propertyDeclarationTypes.enabled": true,
+  "typescript.inlayHints.functionLikeReturnTypes.enabled": true,
+  "typescript.inlayHints.enumMemberValues.enabled": true,
+  "javascript.validate.enable": false,
+  "javascript.format.enable": false,
+  "typescript.format.enable": false,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "[css]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "prettier.requireConfig": true,
+  "prettier.documentSelectors": ["**/*.{js,jsx,ts,tsx,css,json,md,html,yml}"]
+}

CONTRIBUTING.md

@@ -3,14 +3,14 @@
 When contributing to `Readest`, whether on GitHub or in other community spaces:
 
 - Be respectful, civil, and open-minded.
-- Before opening a new pull request, try searching through the [issue tracker](https://github.com/chrox/readest/issues) for known issues or fixes.
+- Before opening a new pull request, try searching through the [issue tracker](https://github.com/readest/readest/issues) for known issues or fixes.
 - If you want to make code changes based on your personal opinion(s), make sure you open an issue first describing the changes you want to make, and open a pull request only when your suggestions get approved by maintainers.
 
 ## How to Contribute
 
 ### Prerequisites
 
-In order to not waste your time implementing a change that has already been declined, or is generally not needed, start by [opening an issue](https://github.com/chrox/readest/issues/new/choose) describing the problem you would like to solve.
+In order to not waste your time implementing a change that has already been declined, or is generally not needed, start by [opening an issue](https://github.com/readest/readest/issues/new/choose) describing the problem you would like to solve.
 
 For the best experience to build Readest for yourself, use a recent version of Node.js and Rust. Refer to the [Tauri documentation](https://v2.tauri.app/start/prerequisites/) for details on setting up the development environment prerequisites on different platforms.
 
@@ -43,8 +43,8 @@ git submodule update --init --recursive
 ```bash
 # might need to rerun this when code is updated
 pnpm install
-# copy pdfjs-dist to Next.js public directory
-pnpm --filter @readest/readest-app setup-pdfjs
+# copy vendors dist libs to public directory
+pnpm --filter @readest/readest-app setup-vendors
 ```
 
 #### 3. Verify Dependencies Installation

Cargo.toml

@@ -1,3 +1,42 @@
 [workspace]
-members = ["apps/readest-app/src-tauri"]
+members = [
+  "apps/readest-app/src-tauri",
+  "packages/tauri/crates/tauri",
+  "packages/tauri/crates/tauri-utils",
+  "packages/tauri/crates/tauri-build",
+  "packages/tauri-plugins/plugins/deep-link",
+  "packages/tauri-plugins/plugins/single-instance"
+]
 resolver = "2"
+
+[workspace.dependencies]
+serde = { version = "1", features = ["derive"] }
+tracing = "0.1"
+log = "0.4"
+tauri = { version = "2", default-features = false }
+tauri-build = "2"
+tauri-plugin = "2"
+tauri-utils = "2"
+schemars = "0.8"
+serde_json = "1"
+thiserror = "2"
+glob = "0.3"
+zbus = "5.9"
+dunce = "1"
+url = "2"
+
+[workspace.package]
+authors = ["Bilingify LLC"]
+homepage = "https://readest.com"
+license = "AGPL-3.0"
+repository = "https://github.com/readest/readest"
+categories = []
+edition = "2021"
+rust-version = "1.77.2"
+
+[patch.crates-io]
+tauri = { path = "packages/tauri/crates/tauri" }
+tauri-utils = { path = "packages/tauri/crates/tauri-utils" }
+tauri-build = { path = "packages/tauri/crates/tauri-build" }
+tauri-plugin-deep-link = { path = "packages/tauri-plugins/plugins/deep-link" }
+tauri-plugin-single-instance = { path = "packages/tauri-plugins/plugins/single-instance" }

Dockerfile

@@ -5,31 +5,13 @@ ENV PATH="${PATH}:${PNPM_HOME}"
 
 RUN npm install --global pnpm
 
-# Install necessary packages
-RUN apt update -y && apt install -y --no-install-recommends \
-    libwebkit2gtk-4.1-dev \
-    build-essential \
-    curl \
-    wget \
-    file \
-    libxdo-dev \
-    libssl-dev \
-    libayatana-appindicator3-dev \
-    librsvg2-dev \
-    ca-certificates \
-    && apt-get clean && rm -rf /var/lib/apt/lists/*
-
-# Install Rust and Cargo
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
-ENV PATH="/root/.cargo/bin:${PATH}"
-
 COPY . /app
 
 WORKDIR /app
 
 RUN pnpm install
 
-RUN pnpm --filter @readest/readest-app setup-pdfjs
+RUN pnpm --filter @readest/readest-app setup-vendors
 
 WORKDIR /app/apps/readest-app
 

README.md

@@ -5,18 +5,22 @@
   <h1>Readest</h1>
   <br>
 
-[Readest][link-website] is an open-source ebook reader designed for immersive and deep reading experiences. Built as a modern rewrite of [Foliate](https://github.com/johnfactotum/foliate), it leverages [Next.js 15](https://github.com/vercel/next.js) and [Tauri v2](https://github.com/tauri-apps/tauri) to deliver a smooth, cross-platform experience across macOS, Windows, Linux, Android, iOS, and the Web.
+[Readest][link-website] is an open-source ebook reader designed for immersive and deep reading experiences. Built as a modern rewrite of [Foliate](https://github.com/johnfactotum/foliate), it leverages [Next.js 16](https://github.com/vercel/next.js) and [Tauri v2](https://github.com/tauri-apps/tauri) to deliver a smooth, cross-platform experience across macOS, Windows, Linux, Android, iOS, and the Web.
 
 [![Website][badge-website]][link-website]
 [![Web App][badge-web-app]][link-web-readest]
 [![OS][badge-platforms]][link-website]
 <br>
-[![][badge-hellogithub]][link-hellogithub]
-[![][badge-discord]][link-discord]
+[![Discord][badge-discord]][link-discord]
+[![Reddit][badge-reddit]][link-reddit]
 [![AGPL Licence][badge-license]](LICENSE)
+[![Language Coverage][badge-language-coverage]][link-locales]
+[![Donate][badge-donate]][link-donate]
 [![Latest release][badge-release]][link-gh-releases]
 [![Last commit][badge-last-commit]][link-gh-commits]
 [![Commits][badge-commit-activity]][link-gh-pulse]
+[![][badge-hellogithub]][link-hellogithub]
+[![Ask DeepWiki][badge-deepwiki]][link-deepwiki]
 
 </div>
 
@@ -26,7 +30,8 @@
   <a href="#screenshots">Screenshots</a> •
   <a href="#downloads">Downloads</a> •
   <a href="#getting-started">Getting Started</a> •
-  <a href="#contributors">Contributors</a> •
+  <a href="#troubleshooting">Troubleshooting</a> •
+  <a href="#support">Support</a> •
   <a href="#license">License</a>
 </p>
 
@@ -40,37 +45,38 @@
 
 <div align="left">✅ Implemented</div>
 
-| **Feature**                             | **Description**                                                                                | **Status** |
-| --------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------- |
-| **Multi-Format Support**                | Support EPUB, MOBI, KF8 (AZW3), FB2, CBZ, PDF (experimental)                                   | ✅         |
-| **Scroll/Page View Modes**              | Switch between scrolling or paginated reading modes.                                           | ✅         |
-| **Full-Text Search**                    | Search across the entire book to find relevant sections.                                       | ✅         |
-| **Annotations and Highlighting**        | Add highlights, bookmarks, and notes to enhance your reading experience.                       | ✅         |
-| **Excerpt Text for Note-Taking**        | Easily excerpt text from books for detailed notes and analysis.                                | ✅         |
-| **Dictionary/Wikipedia Lookup**         | Instantly look up words and terms when reading.                                                | ✅         |
-| **Translate with DeepL**                | Translate selected text instantly using DeepL for accurate translations.                       | ✅         |
-| **[Parallel Read][link-parallel-read]** | Read two books or documents simultaneously in a split-screen view.                             | ✅         |
-| **Customize Font and Layout**           | Adjust font, layout, theme mode, and theme colors for a personalized experience.               | ✅         |
-| **File Association and Open With**      | Quickly open files in Readest in your file browser with one-click.                             | ✅         |
-| **Sync across Platforms**               | Synchronize book files, reading progress, notes, and bookmarks across all supported platforms. | ✅         |
-| **Text-to-Speech (TTS) Support**        | Enable text-to-speech functionality for a more accessible reading experience.                  | ✅         |
+| **Feature**                             | **Description**                                                                                                | **Status** |
+| --------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ---------- |
+| **Multi-Format Support**                | Support EPUB, MOBI, KF8 (AZW3), FB2, CBZ, TXT, PDF (experimental)                                              | ✅         |
+| **Scroll/Page View Modes**              | Switch between scrolling or paginated reading modes.                                                           | ✅         |
+| **Full-Text Search**                    | Search across the entire book to find relevant sections.                                                       | ✅         |
+| **Annotations and Highlighting**        | Add highlights, bookmarks, and notes to enhance your reading experience.                                       | ✅         |
+| **Excerpt Text for Note-Taking**        | Easily excerpt text from books for detailed notes and analysis.                                                | ✅         |
+| **Dictionary/Wikipedia Lookup**         | Instantly look up words and terms when reading.                                                                | ✅         |
+| **[Parallel Read][link-parallel-read]** | Read two books or documents simultaneously in a split-screen view.                                             | ✅         |
+| **Customize Font and Layout**           | Adjust font, layout, theme mode, and theme colors for a personalized experience.                               | ✅         |
+| **File Association and Open With**      | Quickly open files in Readest in your file browser with one-click.                                             | ✅         |
+| **Sync across Platforms**               | Synchronize book files, reading progress, notes, and bookmarks across all supported platforms.                 | ✅         |
+| **Accessibility**                       | Provides full keyboard navigation and supports for screen readers such as VoiceOver, TalkBack, NVDA, and Orca. | ✅         |
+| **Translate with DeepL and Yandex**     | From a single sentence to the entire book—translate instantly.                                                 | ✅         |
+| **Text-to-Speech (TTS) Support**        | Enjoy smooth, multilingual narration—even within a single book.                                                | ✅         |
+| **Library Management**                  | Organize, sort, and manage your entire ebook library.                                                          | ✅         |
+| **OPDS/Calibre Integration**            | Integrate OPDS/Calibre to access online libraries and catalogs.                                                | ✅         |
+| **Code Syntax Highlighting**            | Read software manuals with rich coloring of code examples.                                                     | ✅         |
 
 ## Planned Features
 
 <div align="left">🛠 Building</div>
 <div align="left">🔄 Planned</div>
 
-| **Feature**                     | **Description**                                                                            | **Priority** |
-| ------------------------------- | ------------------------------------------------------------------------------------------ | ------------ |
-| **Library Management**          | Organize, sort, and manage your entire ebook library.                                      | 🛠           |
-| **AI-Powered Summarization**    | Generate summaries of books or chapters using AI for quick insights.                       | 🛠           |
-| **Sync with Koreader**          | Synchronize reading progress, notes, and bookmarks with [Koreader][link-koreader] devices. | 🔄           |
-| **Keyboard Navigation**         | Implement vimium-style keybindings for book navigation.                                    | 🔄           |
-| **Support OPDS/Calibre**        | Integrate OPDS/Calibre to access online libraries and catalogs.                            | 🔄           |
-| **Audiobook Support**           | Extend functionality to play and manage audiobooks.                                        | 🔄           |
-| **Handwriting Annotations**     | Add support for handwriting annotations using a pen on compatible devices.                 | 🔄           |
-| **Advanced Reading Stats**      | Track reading time, pages read, and more for detailed insights.                            | 🔄           |
-| **In-Library Full-Text Search** | Search across your entire ebook library to find topics and quotes.                         | 🔄           |
+| **Feature**                                | **Description**                                                                            | **Priority** |
+| ------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------ |
+| [**Sync with Koreader**][link-kosync-wiki] | Synchronize reading progress, notes, and bookmarks with [Koreader][link-koreader] devices. | 🛠           |
+| **AI-Powered Summarization**               | Generate summaries of books or chapters using AI for quick insights.                       | 🛠           |
+| **Audiobook Support**                      | Extend functionality to play and manage audiobooks.                                        | 🔄           |
+| **Handwriting Annotations**                | Add support for handwriting annotations using a pen on compatible devices.                 | 🔄           |
+| **Advanced Reading Stats**                 | Track reading time, pages read, and more for detailed insights.                            | 🔄           |
+| **In-Library Full-Text Search**            | Search across your entire ebook library to find topics and quotes.                         | 🔄           |
 
 Stay tuned for continuous improvements and updates! Contributions and suggestions are always welcome—let's build the ultimate reading experience together. 😊
 
@@ -78,25 +84,35 @@ Stay tuned for continuous improvements and updates! Contributions and suggestion
 
 ![Annotations](./data/screenshots/annotations.png)
 
-![DeepL](./data/screenshots/deepl.png)
-
 ![TTS](./data/screenshots/tts_speak_aloud.png)
 
+![DeepL](./data/screenshots/deepl.png)
+
 ![Footnote](./data/screenshots/footnote_popover.png)
 
 ![Wikipedia](./data/screenshots/wikipedia_vertical.png)
 
-![Themeing Dark Mode](./data/screenshots/theming_dark_mode.png)
+![Theming Dark Mode](./data/screenshots/theming_dark_mode.png)
 
 ---
 
 ## Downloads
 
-The Readest app is available for download! 🥳 🚀
+### Mobile Apps
 
-- macOS / iOS / iPadOS : Search for "Readest" on the [App Store][link-appstore], also available on TestFlight for beta test (send your Apple ID to readestapp@gmail.com to request access).
-- Windows / Linux / Android: Visit [https://readest.com][link-website] or the [Releases on GitHub][link-gh-releases].
-- Web: Visit [https://web.readest.com][link-web-readest].
+<div align="center">
+  <a href="https://apps.apple.com/app/id6738622779">
+    <img alt="Download on the App Store" src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" style="height: 50px;" /></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://play.google.com/store/apps/details?id=com.bilingify.readest">
+    <img alt="Get it on Google Play" src="https://upload.wikimedia.org/wikipedia/commons/7/78/Google_Play_Store_badge_EN.svg" style="height: 50px;" /></a>
+</div>
+
+### Platform-Specific Downloads
+
+- macOS / iOS / iPadOS : Search and install **Readest** on the [App Store][link-appstore], _also_ available on TestFlight for beta test (send your Apple ID to <readestapp@gmail.com> to request access).
+- Windows / Linux / Android: Visit and download **Readest** at [https://readest.com][link-website] or the [Releases on GitHub][link-gh-releases].
+- Linux users can also install [Readest on Flathub][link-flathub].
+- Web: Visit and use **Readest for Web** at [https://web.readest.com][link-web-readest].
 
 ## Requirements
 
@@ -121,16 +137,16 @@ To get started with Readest, follow these steps to clone and build the project.
 ```bash
 git clone https://github.com/readest/readest.git
 cd readest
-git submodule update --init --recursive
 ```
 
 ### 2. Install Dependencies
 
 ```bash
 # might need to rerun this when code is updated
+git submodule update --init --recursive
 pnpm install
-# copy pdfjs-dist to Next.js public directory
-pnpm --filter @readest/readest-app setup-pdfjs
+# copy vendors dist libs to public directory
+pnpm --filter @readest/readest-app setup-vendors
 ```
 
 ### 3. Verify Dependencies Installation
@@ -152,6 +168,8 @@ For Windows targets, “Build Tools for Visual Studio 2022” (or a higher editi
 pnpm tauri dev
 # or start development for the Web app
 pnpm dev-web
+# preview with OpenNext build for the Web app
+pnpm preview
 ```
 
 For Android:
@@ -199,6 +217,39 @@ nix develop ./ops#android # enter a dev shell for the android app
 
 Please check the [wiki][link-gh-wiki] of this project for more information on development.
 
+## Troubleshooting
+
+### 1. Readest Won’t Launch on Windows (Missing Edge WebView2 Runtime)
+
+**Symptom**
+
+- When you double-click readest.exe, nothing happens. No window appears, and Task Manager does not show the process.
+- This can affect both the standard installer and the portable version.
+
+**Cause**
+
+- Microsoft Edge WebView2 Runtime is either missing, outdated, or improperly installed on your system. Readest depends on WebView2 to render the interface on Windows.
+
+**How to Fix**
+
+1. Check if WebView2 is installed
+   - Open “Add or Remove Programs” (a.k.a. Apps & features) on Windows. Look for “Microsoft Edge WebView2 Runtime.”
+2. Install or Update WebView2
+   - Download the WebView2 Runtime directly from Microsoft: [link](https://developer.microsoft.com/en-us/microsoft-edge/webview2?form=MA13LH).
+   - If you prefer an offline installer, download the offline package and run it as an Administrator.
+3. Re-run Readest
+   - After installing/updating WebView2, launch readest.exe again.
+   - If you still encounter problems, reboot your PC and try again.
+
+**Additional Tips**
+
+- If reinstalling once doesn’t work, uninstall Edge WebView2 completely, then reinstall it with Administrator privileges.
+- Verify your Windows installation has the latest updates from Microsoft.
+
+**Still Stuck?**
+
+- See Issue [readest/readest#358](https://github.com/readest/readest/issues/358) for further details, or head over to our [Discord][link-discord] server and open a support discussion with detailed logs of your environment and the steps you’ve taken.
+
 ## Contributors
 
 Readest is open-source, and contributions are welcome! Feel free to open issues, suggest features, or submit pull requests. Please **review our [contributing guidelines](CONTRIBUTING.md) before you start**. We also welcome you to join our [Discord][link-discord] community for either support or contributing guidance.
@@ -209,6 +260,18 @@ Readest is open-source, and contributions are welcome! Feel free to open issues,
   </p>
 </a>
 
+## Support
+
+If Readest has been useful to you, consider supporting its development. You can [become a sponsor on GitHub](https://github.com/sponsors/readest), [donate via Stripe](https://donate.stripe.com/4gMcN5aZdcE52kW3TFgjC01), or [contribute with crypto](https://donate.readest.com). Your contribution helps us squash bugs faster, improve performance, and keep building great features.
+
+### Sponsors
+
+<p align="center">
+  <a title="Browser testing via TestMu AI" href="https://www.testmu.ai?utm_source=readest&utm_medium=sponsor" target="_blank">
+    <img src="https://raw.githubusercontent.com/readest/readest/refs/heads/main/data/sponsors/testmu-ai-logo.png" style="vertical-align: middle;" width="250" />
+  </a>
+</p>
+
 ## License
 
 Readest is free software: you can redistribute it and/or modify it under the terms of the [GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.html) as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See the [LICENSE](LICENSE) file for details.
@@ -219,9 +282,11 @@ The following libraries and frameworks are used in this software:
 - [zip.js](https://github.com/gildas-lormeau/zip.js), which is licensed under the BSD-3-Clause license.
 - [fflate](https://github.com/101arrowz/fflate), which is MIT licensed.
 - [PDF.js](https://github.com/mozilla/pdf.js), which is licensed under Apache License 2.0.
+- [daisyUI](https://github.com/saadeghi/daisyui), which is MIT licensed.
+- [marked](https://github.com/markedjs/marked), which is MIT licensed.
 - [next.js](https://github.com/vercel/next.js), which is MIT licensed.
-- [react](https://github.com/facebook/react), which is MIT licensed.
 - [react-icons](https://github.com/react-icons/react-icons), which has various open-source licenses.
+- [react](https://github.com/facebook/react), which is MIT licensed.
 - [tauri](https://github.com/tauri-apps/tauri), which is MIT licensed.
 
 The following fonts are utilized in this software, either bundled within the application or provided through web fonts:
@@ -237,12 +302,18 @@ The following fonts are utilized in this software, either bundled within the app
 [badge-license]: https://img.shields.io/github/license/readest/readest?color=teal
 [badge-release]: https://img.shields.io/github/release/readest/readest?color=green
 [badge-platforms]: https://img.shields.io/badge/platforms-macOS%2C%20Windows%2C%20Linux%2C%20Android%2C%20iOS%2C%20Web%2C%20PWA-green
-[badge-last-commit]: https://img.shields.io/github/last-commit/readest/readest?color=green
-[badge-commit-activity]: https://img.shields.io/github/commit-activity/m/readest/readest
+[badge-last-commit]: https://img.shields.io/github/last-commit/readest/readest?color=blue
+[badge-commit-activity]: https://img.shields.io/github/commit-activity/m/readest/readest?color=blue
 [badge-discord]: https://img.shields.io/discord/1314226120886976544?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square
 [badge-hellogithub]: https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=8a5b6ade2aee461a8bd94e59200682a7&claim_uid=eRLUbPOy2qZtDgw&theme=small
+[badge-donate]: https://donate.readest.com/badge.svg
+[badge-deepwiki]: https://deepwiki.com/badge.svg
+[badge-reddit]: https://img.shields.io/reddit/subreddit-subscribers/readest?style=flat&logo=reddit&color=F37E41
+[badge-language-coverage]: https://img.shields.io/badge/coverage-53%25%20population%20🌍-green
+[link-donate]: https://donate.readest.com/?tickers=btc%2Ceth%2Csol%2Cusdc
 [link-appstore]: https://apps.apple.com/app/apple-store/id6738622779?pt=127463130&ct=github&mt=8
 [link-website]: https://readest.com?utm_source=github&utm_medium=referral&utm_campaign=readme
+[link-flathub]: https://flathub.org/en/apps/com.bilingify.readest
 [link-web-readest]: https://web.readest.com
 [link-gh-releases]: https://github.com/readest/readest/releases
 [link-gh-commits]: https://github.com/readest/readest/commits/main
@@ -252,3 +323,7 @@ The following fonts are utilized in this software, either bundled within the app
 [link-parallel-read]: https://readest.com/#parallel-read
 [link-koreader]: https://github.com/koreader/koreader
 [link-hellogithub]: https://hellogithub.com/repository/8a5b6ade2aee461a8bd94e59200682a7
+[link-deepwiki]: https://deepwiki.com/readest/readest
+[link-locales]: https://github.com/readest/readest/tree/main/apps/readest-app/public/locales
+[link-kosync-wiki]: https://github.com/readest/readest/wiki/Sync-with-Koreader-devices
+[link-reddit]: https://reddit.com/r/readest/

apps/readest-app/.env

@@ -2,5 +2,11 @@ PDFJS_BUILD_PATH=../../packages/foliate-js/node_modules/pdfjs-dist/legacy/build
 PDFJS_FONTS_PATH=../../packages/foliate-js/node_modules/pdfjs-dist
 PDFJS_STYLE_PATH=../../packages/foliate-js/vendor/pdfjs
 
-NEXT_PUBLIC_DEV_SUPABASE_URL=https://gxkhxxxeapexynpouyjz.supabase.co
-NEXT_PUBLIC_DEV_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Imd4a2h4eHhlYXBleHlucG91eWp6Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzQ0MzAwNTksImV4cCI6MjA1MDAwNjA1OX0.jhinkQsimQoidsg_U59YD5ROw4PmMJQNKuyXbr4TiQA
+NEXT_PUBLIC_DEFAULT_POSTHOG_URL_BASE64="aHR0cHM6Ly91cy5pLnBvc3Rob2cuY29t"
+NEXT_PUBLIC_DEFAULT_POSTHOG_KEY_BASE64="cGhjX2ViNXowbVRxWm8yZm5YYnZGNmE3bFh5TThpTmRSNTNsR1A3VFM3VGh4S08="
+
+NEXT_PUBLIC_DEFAULT_SUPABASE_URL_BASE64="aHR0cHM6Ly9yZWFkZXN0LnN1cGFiYXNlLmNv"
+NEXT_PUBLIC_DEFAULT_SUPABASE_KEY_BASE64="ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SnBjM01pT2lKemRYQmhZbUZ6WlNJc0luSmxaaUk2SW5aaWMzbDRablZ6YW1weFpIaHJhbkZzZVhOaklpd2ljbTlzWlNJNkltRnViMjRpTENKcFlYUWlPakUzTXpReE1qTTJOekVzSW1WNGNDSTZNakEwT1RZNU9UWTNNWDAuM1U1VXFhb3VfMVNnclZlMWVvOXJBcGMwdUtqcWhwUWRVWGh2d1VIbVVmZw=="
+
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY_DEV_BASE64="cGtfdGVzdF81MVJmQmdLRTdSWW5pTWsxc0tDV2RUd2hMZzcySzk4eDRWcjlIdDdsRFBONngzcnpZYmhydGtNQnpDdzZKbHFaRVVITVp5eVNjVXhCZXVkcGppWTk0WXNHcDAweFlRRnRRaUU="
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY_BASE64="cGtfbGl2ZV81MVFYN3dRRU5ndjJFOUxQRHpZUlE5TlJJeTNjd09EZ1AzSkNFRHRPWlFtdFJWc3Brd053ZE1NNUpIVnVPTmJWcjZ3VGFCMUNZR1pJMmRPVWppTkY0bHJvVjAwalE4TkpkdWk="

apps/readest-app/.env.local.example

@@ -4,14 +4,29 @@ NEXT_PUBLIC_POSTHOG_HOST=YOUR_POSTHOG_HOST
 NEXT_PUBLIC_SUPABASE_URL=YOUR_SUPABASE_URL
 NEXT_PUBLIC_SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY
 
+NEXT_PUBLIC_STORAGE_FIXED_QUOTA=1073741824
+
+NEXT_PUBLIC_API_BASE_URL=https://your-api-base-url.com
+
 SUPABASE_ADMIN_KEY=YOUR_SUPABASE_ADMIN_KEY
 
 DEEPL_PRO_API_KEYS=YOUR_DEEPL_PRO_API_KEYS
 DEEPL_FREE_API_KEYS=YOUR_DEEPL_FREE_API_KEYS
 
+# r2, s3
+NEXT_PUBLIC_OBJECT_STORAGE_TYPE=r2
+
 R2_TOKEN_VALUE=YOUR_R2_TOKEN_VALUE
 R2_ACCESS_KEY_ID=YOUR_R2_ACCESS_KEY_ID
 R2_SECRET_ACCESS_KEY=YOUR_R2_SECRET_ACCESS_KEY
 R2_BUCKET_NAME=YOUR_R2_BUCKET_NAME
 R2_ACCOUNT_ID=YOUR_R2_ACCOUNT_ID
 R2_REGION=YOUR_R2_REGION
+
+S3_ENDPOINT=PLACE_HOLDER
+S3_ACCESS_KEY_ID=PLACE_HOLDER
+S3_SECRET_ACCESS_KEY=PLACE_HOLDER
+S3_BUCKET_NAME=PLACE_HOLDER
+S3_REGION=PLACE_HOLDER
+
+TEMP_STORAGE_PUBLIC_BUCKET_NAME=PLACE_HOLDER

apps/readest-app/.env.tauri

@@ -1 +1,3 @@
-NEXT_PUBLIC_APP_PLATFORM=tauri
+NEXT_PUBLIC_APP_PLATFORM=tauri
+
+DBUS_ID=com.bilingify.readest

apps/readest-app/.env.tauri.example

@@ -0,0 +1,2 @@
+NEXT_PUBLIC_APP_PLATFORM=tauri
+AI_GATEWAY_API_KEY=your_key_here

apps/readest-app/.env.web.example

@@ -0,0 +1,3 @@
+NEXT_PUBLIC_APP_PLATFORM=web
+AI_GATEWAY_API_KEY=your_key_here
+NEXT_PUBLIC_AI_GATEWAY_API_KEY=your_key_here

apps/readest-app/.gitignore

@@ -32,7 +32,7 @@ yarn-error.log*
 /private_keys
 
 # plists
-*.plist
+Entitlements*.plist
 
 # local confs
 tauri.*.conf.json

apps/readest-app/components.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "src/styles/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/utils",
+    "ui": "@/components/ui",
+    "lib": "@/libs",
+    "hooks": "@/hooks"
+  },
+  "registries": {}
+}

apps/readest-app/eslint.config.mjs

@@ -1,13 +1,35 @@
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import js from "@eslint/js";
-import { FlatCompat } from "@eslint/eslintrc";
+import { defineConfig, globalIgnores } from 'eslint/config';
+import next from 'eslint-config-next';
+import nextVitals from 'eslint-config-next/core-web-vitals';
+import tseslint from 'eslint-config-next/typescript';
+import jsxA11y from 'eslint-plugin-jsx-a11y';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const compat = new FlatCompat({
-    baseDirectory: __dirname,
-    recommendedConfig: js.configs.recommended,
-    allConfig: js.configs.all
-});
-export default [...compat.extends("next/core-web-vitals", "next/typescript")];
+const eslintConfig = defineConfig([
+  ...tseslint,
+  ...next,
+  ...nextVitals,
+  {
+    rules: {
+      ...jsxA11y.configs.recommended.rules,
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+    },
+  },
+  globalIgnores([
+    'node_modules/**',
+    '.next/**',
+    '.open-next/**',
+    'out/**',
+    'build/**',
+    'public/**',
+    'next-env.d.ts',
+  ]),
+]);
+
+export default eslintConfig;

apps/readest-app/extensions/windows-thumbnail/Cargo.lock

@@ -0,0 +1,588 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "adler2"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
+
+[[package]]
+name = "anyhow"
+version = "1.0.100"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61"
+
+[[package]]
+name = "arbitrary"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3d036a3c4ab069c7b410a2ce876bd74808d2d0888a82667669f8e783a898bf1"
+dependencies = [
+ "derive_arbitrary",
+]
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "base64"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
+
+[[package]]
+name = "bitflags"
+version = "2.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "812e12b5285cc515a9c72a5c1d3b6d46a19dac5acfef5265968c166106e31dd3"
+
+[[package]]
+name = "bumpalo"
+version = "3.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "46c5e41b57b8bba42a04676d81cb89e9ee8e859a1a66f80a5a72e1cb76b34d43"
+
+[[package]]
+name = "bytemuck"
+version = "1.24.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbdf580320f38b612e485521afda1ee26d10cc9884efaaa750d383e13e3c5f4"
+
+[[package]]
+name = "byteorder-lite"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f1fe948ff07f4bd06c30984e69f5b4899c516a3ef74f34df92a2df2ab535495"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "color_quant"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d7b894f5411737b7867f4827955924d7c254fc9f4d91a6aad6b097804b1018b"
+
+[[package]]
+name = "crc32fast"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9481c1c90cbf2ac953f07c8d4a58aa3945c425b7185c9154d67a65e4230da511"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "derive_arbitrary"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e567bd82dcff979e4b03460c307b3cdc9e96fde3d73bed1496d2bc75d9dd62a"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "directories-next"
+version = "2.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "339ee130d97a610ea5a5872d2bbb130fdf68884ff09d3028b81bec8a1ac23bbc"
+dependencies = [
+ "cfg-if",
+ "dirs-sys-next",
+]
+
+[[package]]
+name = "dirs-sys-next"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ebda144c4fe02d1f7ea1a7d9641b6fc6b580adcfa024ae48797ecdeb6825b4d"
+dependencies = [
+ "libc",
+ "redox_users",
+ "winapi",
+]
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "fdeflate"
+version = "0.3.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e6853b52649d4ac5c0bd02320cddc5ba956bdb407c4b75a2c6b75bf51500f8c"
+dependencies = [
+ "simd-adler32",
+]
+
+[[package]]
+name = "flate2"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfe33edd8e85a12a67454e37f8c75e730830d83e313556ab9ebf9ee7fbeb3bfb"
+dependencies = [
+ "crc32fast",
+ "libz-rs-sys",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "gif"
+version = "0.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f954a9e9159ec994f73a30a12b96a702dde78f5547bcb561174597924f7d4162"
+dependencies = [
+ "color_quant",
+ "weezl",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "841d1cc9bed7f9236f321df977030373f4a4163ae1a7dbfe1a51a2c1a51d9100"
+
+[[package]]
+name = "image"
+version = "0.25.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6506c6c10786659413faa717ceebcb8f70731c0a60cbae39795fdf114519c1a"
+dependencies = [
+ "bytemuck",
+ "byteorder-lite",
+ "color_quant",
+ "gif",
+ "image-webp",
+ "moxcms",
+ "num-traits",
+ "png",
+ "zune-core",
+ "zune-jpeg",
+]
+
+[[package]]
+name = "image-webp"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "525e9ff3e1a4be2fbea1fdf0e98686a6d98b4d8f937e1bf7402245af1909e8c3"
+dependencies = [
+ "byteorder-lite",
+ "quick-error",
+]
+
+[[package]]
+name = "indexmap"
+version = "2.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ad4bb2b565bca0645f4d68c5c9af97fba094e9791da685bf83cb5f3ce74acf2"
+dependencies = [
+ "equivalent",
+ "hashbrown",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.177"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2874a2af47a2325c2001a6e6fad9b16a53b802102b528163885171cf92b15976"
+
+[[package]]
+name = "libredox"
+version = "0.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "416f7e718bdb06000964960ffa43b4335ad4012ae8b99060261aa4a8088d5ccb"
+dependencies = [
+ "bitflags",
+ "libc",
+]
+
+[[package]]
+name = "libz-rs-sys"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "840db8cf39d9ec4dd794376f38acc40d0fc65eec2a8f484f7fd375b84602becd"
+dependencies = [
+ "zlib-rs",
+]
+
+[[package]]
+name = "log"
+version = "0.4.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34080505efa8e45a4b816c349525ebe327ceaa8559756f0356cba97ef3bf7432"
+
+[[package]]
+name = "md5"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae960838283323069879657ca3de837e9f7bbb4c7bf6ea7f1b290d5e9476d2e0"
+
+[[package]]
+name = "memchr"
+version = "2.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f52b00d39961fc5b2736ea853c9cc86238e165017a493d1d5c8eac6bdc4cc273"
+
+[[package]]
+name = "miniz_oxide"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
+dependencies = [
+ "adler2",
+ "simd-adler32",
+]
+
+[[package]]
+name = "moxcms"
+version = "0.7.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "80986bbbcf925ebd3be54c26613d861255284584501595cf418320c078945608"
+dependencies = [
+ "num-traits",
+ "pxfm",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "png"
+version = "0.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97baced388464909d42d89643fe4361939af9b7ce7a31ee32a168f832a70f2a0"
+dependencies = [
+ "bitflags",
+ "crc32fast",
+ "fdeflate",
+ "flate2",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ee95bc4ef87b8d5ba32e8b7714ccc834865276eab0aed5c9958d00ec45f49e8"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pxfm"
+version = "0.1.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b3502d6155304a4173a5f2c34b52b7ed0dd085890326cb50fd625fdf39e86b3b"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "quick-error"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a993555f31e5a609f617c12db6250dedcac1b0a85076912c436e6fc9b2c8e6a3"
+
+[[package]]
+name = "quote"
+version = "1.0.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "redox_users"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba009ff324d1fc1b900bd1fdb31564febe58a8ccc8a6fdbb93b543d33b13ca43"
+dependencies = [
+ "getrandom",
+ "libredox",
+ "thiserror",
+]
+
+[[package]]
+name = "simd-adler32"
+version = "0.3.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d66dc143e6b11c1eddc06d5c423cfc97062865baf299914ab64caa38182078fe"
+
+[[package]]
+name = "syn"
+version = "2.0.111"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "390cc9a294ab71bdb1aa2e99d13be9c753cd2d7bd6560c77118597410c4d2e87"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "thiserror"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "weezl"
+version = "0.1.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a28ac98ddc8b9274cb41bb4d9d4d5c425b6020c50c46f25559911905610b4a88"
+
+[[package]]
+name = "winapi"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
+dependencies = [
+ "winapi-i686-pc-windows-gnu",
+ "winapi-x86_64-pc-windows-gnu",
+]
+
+[[package]]
+name = "winapi-i686-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
+
+[[package]]
+name = "winapi-x86_64-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "windows"
+version = "0.62.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "527fadee13e0c05939a6a05d5bd6eec6cd2e3dbd648b9f8e447c6518133d8580"
+dependencies = [
+ "windows-collections",
+ "windows-core",
+ "windows-future",
+ "windows-numerics",
+]
+
+[[package]]
+name = "windows-collections"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "23b2d95af1a8a14a3c7367e1ed4fc9c20e0a26e79551b1454d72583c97cc6610"
+dependencies = [
+ "windows-core",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.62.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
+dependencies = [
+ "windows-implement",
+ "windows-interface",
+ "windows-link",
+ "windows-result",
+ "windows-strings",
+]
+
+[[package]]
+name = "windows-future"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e1d6f90251fe18a279739e78025bd6ddc52a7e22f921070ccdc67dde84c605cb"
+dependencies = [
+ "windows-core",
+ "windows-link",
+ "windows-threading",
+]
+
+[[package]]
+name = "windows-implement"
+version = "0.60.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "053e2e040ab57b9dc951b72c264860db7eb3b0200ba345b4e4c3b14f67855ddf"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "windows-interface"
+version = "0.59.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f316c4a2570ba26bbec722032c4099d8c8bc095efccdc15688708623367e358"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-numerics"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e2e40844ac143cdb44aead537bbf727de9b044e107a0f1220392177d15b0f26"
+dependencies = [
+ "windows-core",
+ "windows-link",
+]
+
+[[package]]
+name = "windows-result"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows-threading"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3949bd5b99cafdf1c7ca86b43ca564028dfe27d66958f2470940f73d86d75b37"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows_thumbnail"
+version = "0.1.0"
+dependencies = [
+ "anyhow",
+ "base64",
+ "directories-next",
+ "image",
+ "md5",
+ "once_cell",
+ "windows",
+ "windows-core",
+ "zip",
+]
+
+[[package]]
+name = "zip"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eb2a05c7c36fde6c09b08576c9f7fb4cda705990f73b58fe011abf7dfb24168b"
+dependencies = [
+ "arbitrary",
+ "crc32fast",
+ "flate2",
+ "indexmap",
+ "memchr",
+ "zopfli",
+]
+
+[[package]]
+name = "zlib-rs"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f06ae92f42f5e5c42443fd094f245eb656abf56dd7cce9b8b263236565e00f2"
+
+[[package]]
+name = "zopfli"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f05cd8797d63865425ff89b5c4a48804f35ba0ce8d125800027ad6017d2b5249"
+dependencies = [
+ "bumpalo",
+ "crc32fast",
+ "log",
+ "simd-adler32",
+]
+
+[[package]]
+name = "zune-core"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "111f7d9820f05fd715df3144e254d6fc02ee4088b0644c0ffd0efc9e6d9d2773"
+
+[[package]]
+name = "zune-jpeg"
+version = "0.5.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc6fb7703e32e9a07fb3f757360338b3a567a5054f21b5f52a666752e333d58e"
+dependencies = [
+ "zune-core",
+]

apps/readest-app/extensions/windows-thumbnail/Cargo.toml

@@ -0,0 +1,31 @@
+[package]
+name = "windows_thumbnail"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[workspace]
+
+[lib]
+name = "windows_thumbnail"
+path = "src/mod.rs"
+crate-type = ["cdylib"]
+
+[dependencies]
+anyhow = "1"
+base64 = "0.22"
+directories-next = "2.0"
+image = { version = "0.25", default-features = false, features = ["png", "jpeg", "gif", "webp"] }
+md5 = "0.8"
+once_cell = "1.19"
+zip = { version = "6.0", default-features = false, features = ["deflate"] }
+windows = { version = "0.62", features = [
+  "Win32_Foundation",
+  "Win32_Graphics_Gdi",
+  "Win32_Security",
+  "Win32_System_Com",
+  "Win32_System_LibraryLoader",
+  "Win32_System_Registry",
+  "Win32_UI_Shell",
+] }
+windows-core = "0.62"

apps/readest-app/extensions/windows-thumbnail/README.md

@@ -0,0 +1,134 @@
+# Windows Thumbnail Provider for Readest
+
+This crate provides Windows Explorer thumbnail support for eBook files when Readest is set as the default application.
+
+## Features
+
+- **Automatic Cover Extraction**: Extracts cover images from EPUB, MOBI, AZW, AZW3, FB2, CBZ, CBR files
+- **Readest Branding**: Adds a small Readest icon overlay at the bottom-right corner
+- **Smart Caching**: Caches generated thumbnails for faster subsequent loads
+- **File Association Aware**: Only shows thumbnails when Readest is the default app for the file type
+- **COM Integration**: Full Windows Shell extension implementation via `IThumbnailProvider`
+
+## Supported Formats
+
+| Format     | Extension               | Cover Source                 |
+| ---------- | ----------------------- | ---------------------------- |
+| EPUB       | `.epub`                 | OPF manifest cover reference |
+| MOBI/AZW   | `.mobi`, `.azw`, `.prc` | EXTH cover offset            |
+| AZW3/KF8   | `.azw3`, `.kf8`         | KF8 format cover             |
+| FB2        | `.fb2`                  | `<binary>` coverpage element |
+| Comic Book | `.cbz`, `.cbr`          | First image in archive       |
+| Plain Text | `.txt`                  | Generated placeholder        |
+
+## Building
+
+### Library Only
+
+```bash
+cargo build --release
+```
+
+### COM DLL (for Windows Explorer integration)
+
+```bash
+cargo build --release --features com
+```
+
+### CLI Tool
+
+```bash
+cargo build --release --features cli
+```
+
+## Installation
+
+The thumbnail provider DLL is automatically registered when Readest is installed via the NSIS installer.
+
+### Manual Registration (for development)
+
+```powershell
+# Register the DLL
+regsvr32 /s target\release\windows_thumbnail.dll
+
+# Unregister the DLL
+regsvr32 /s /u target\release\windows_thumbnail.dll
+
+# Refresh Explorer to see changes
+ie4uinit.exe -show
+```
+
+After registration, you may need to restart Windows Explorer or log out/in for changes to take effect.
+
+## Usage (Development / Manual testing)
+
+For local development and testing, build the Windows DLL (or the library) from the Readest Tauri app folder and register it manually. The legacy CLI test harness used to live in the separate `packages/tauri` workspace, but the thumbnail handler implementation now lives inside Readest's Tauri app.
+
+Build the DLL (for Windows explorer integration):
+
+```powershell
+cd apps/readest-app/src-tauri
+cargo build --release --manifest-path Cargo.toml --features com
+```
+
+The standalone CLI test harness is no longer distributed with the app. To test the thumbnail provider locally, build and register the DLL as shown above and use a small test harness that imports `readestlib`'s thumbnail code or use Explorer after registering the handler.
+
+Manual registration for development (register the generated DLL):
+
+```powershell
+# Register the DLL
+regsvr32 /s target\release\windows_thumbnail.dll
+
+# Unregister the DLL
+regsvr32 /s /u target\release\windows_thumbnail.dll
+
+# Refresh Explorer to see changes
+ie4uinit.exe -show
+```
+
+This generates a thumbnail with the Readest overlay at the specified size.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    Windows Explorer                              │
+├─────────────────────────────────────────────────────────────────┤
+│                          │                                       │
+│    IThumbnailProvider ───┼──► ThumbnailProvider                  │
+│                          │         │                             │
+│                          │         ▼                             │
+│                          │    Check File Association             │
+│                          │    (is Readest the default?)          │
+│                          │         │                             │
+│                          │         ▼ (if yes)                    │
+│                          │    Extract Cover Image                │
+│                          │         │                             │
+│                          │         ▼                             │
+│                          │    Add Readest Overlay                │
+│                          │         │                             │
+│                          │         ▼                             │
+│                          │    Return HBITMAP                     │
+│                          │                                       │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## COM Details
+
+- **CLSID**: `{A1B2C3D4-E5F6-7890-ABCD-EF1234567890}`
+- **Shell Thumbnail Handler GUID**: `{e357fccd-a995-4576-b01f-234630154e96}`
+- **Threading Model**: Apartment
+
+## How It Works
+
+1. When Windows Explorer needs a thumbnail, it queries the registered shell extension
+2. The COM DLL implements `IInitializeWithItem` to receive the file path
+3. It checks if Readest.exe is the default application for that file type using `AssocQueryStringW`
+4. If Readest is the default, it extracts the cover and generates the thumbnail
+5. If Readest is NOT the default, it returns `S_FALSE` to let Windows use other handlers
+
+This ensures thumbnails only appear for files the user has associated with Readest.
+
+## License
+
+MIT License - See LICENSE file for details.

apps/readest-app/extensions/windows-thumbnail/src/com_provider.rs

@@ -0,0 +1,506 @@
+/// Windows COM Thumbnail Provider for Readest
+///
+/// Implements IThumbnailProvider and IInitializeWithItem for Windows Shell integration.
+/// This allows Windows Explorer to show book covers as thumbnails for eBook files.
+///
+/// **Important**: Thumbnails are only shown when Readest.exe is the default application
+/// for the file type.
+///
+/// ## CLSID: {A1B2C3D4-E5F6-7890-ABCD-EF1234567890}
+use std::cell::UnsafeCell;
+use std::ffi::c_void;
+use std::path::PathBuf;
+use std::sync::atomic::{AtomicIsize, AtomicU32, Ordering};
+
+use windows::core::{IUnknown, Interface, GUID, HRESULT, PCWSTR, PWSTR};
+use windows::Win32::Foundation::{
+    CLASS_E_NOAGGREGATION, E_FAIL, E_INVALIDARG, E_NOINTERFACE, HMODULE, S_FALSE, S_OK,
+};
+use windows::Win32::Graphics::Gdi::{
+    CreateDIBSection, BITMAPINFO, BITMAPINFOHEADER, BI_RGB, DIB_RGB_COLORS, HBITMAP,
+};
+use windows::Win32::System::Com::{CoTaskMemFree, IClassFactory, IClassFactory_Impl};
+use windows::Win32::System::LibraryLoader::GetModuleFileNameW;
+use windows::Win32::System::Registry::{
+    RegCloseKey, RegCreateKeyExW, RegDeleteTreeW, RegSetValueExW, HKEY, HKEY_CLASSES_ROOT,
+    KEY_WRITE, REG_OPTION_NON_VOLATILE, REG_SZ,
+};
+use windows::Win32::UI::Shell::{
+    AssocQueryStringW, IInitializeWithItem, IInitializeWithItem_Impl, IShellItem,
+    IThumbnailProvider, IThumbnailProvider_Impl, ASSOCF_NONE, ASSOCSTR_EXECUTABLE,
+    SIGDN_FILESYSPATH, WTSAT_ARGB, WTS_ALPHATYPE,
+};
+use windows_core::BOOL;
+use windows_core::{implement, Ref};
+
+use super::cached_thumbnail_for_path;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CLSID for Readest Thumbnail Provider
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// CLSID: {A1B2C3D4-E5F6-7890-ABCD-EF1234567890}
+pub const CLSID_READEST_THUMBNAIL: GUID = GUID::from_u128(0xA1B2C3D4_E5F6_7890_ABCD_EF1234567890);
+
+/// Supported file extensions
+pub const SUPPORTED_EXTENSIONS: &[&str] = &[
+    ".epub", ".mobi", ".azw", ".azw3", ".kf8", ".prc", ".fb2", ".cbz", ".cbr", ".txt",
+];
+
+// DLL reference counting
+static DLL_REF_COUNT: AtomicU32 = AtomicU32::new(0);
+static DLL_MODULE_PTR: AtomicIsize = AtomicIsize::new(0);
+
+fn dll_add_ref() {
+    DLL_REF_COUNT.fetch_add(1, Ordering::SeqCst);
+}
+fn dll_release() {
+    DLL_REF_COUNT.fetch_sub(1, Ordering::SeqCst);
+}
+
+fn set_dll_module(h: HMODULE) {
+    DLL_MODULE_PTR.store(h.0 as isize, Ordering::SeqCst);
+}
+
+fn get_dll_module() -> Option<HMODULE> {
+    let ptr = DLL_MODULE_PTR.load(Ordering::SeqCst);
+    if ptr == 0 {
+        None
+    } else {
+        Some(HMODULE(ptr as *mut c_void))
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// File Association Check
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Check if Readest.exe is the default application for a given file extension.
+fn is_readest_default_for_extension(ext: &str) -> bool {
+    let ext_wide: Vec<u16> = ext.encode_utf16().chain(std::iter::once(0)).collect();
+    let mut buffer = [0u16; 260];
+    let mut buffer_size = buffer.len() as u32;
+
+    unsafe {
+        let result = AssocQueryStringW(
+            ASSOCF_NONE,
+            ASSOCSTR_EXECUTABLE,
+            PCWSTR(ext_wide.as_ptr()),
+            None,
+            Some(PWSTR(buffer.as_mut_ptr())),
+            &mut buffer_size,
+        );
+
+        if result.is_ok() {
+            let len = buffer.iter().position(|&c| c == 0).unwrap_or(buffer.len());
+            let path = String::from_utf16_lossy(&buffer[..len]).to_lowercase();
+            return path.contains("readest");
+        }
+    }
+
+    false
+}
+
+/// Check if Readest is the default app for a specific file path.
+fn is_readest_default_for_file(path: &PathBuf) -> bool {
+    if let Some(ext) = path.extension().and_then(|e| e.to_str()) {
+        let ext_with_dot = format!(".{}", ext.to_lowercase());
+        return is_readest_default_for_extension(&ext_with_dot);
+    }
+    false
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ThumbnailProvider
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Interior mutability wrapper for COM single-threaded apartment
+struct ComCell<T>(UnsafeCell<T>);
+
+impl<T> ComCell<T> {
+    fn new(value: T) -> Self {
+        Self(UnsafeCell::new(value))
+    }
+    fn get(&self) -> &T {
+        unsafe { &*self.0.get() }
+    }
+    fn set(&self, value: T) {
+        unsafe {
+            *self.0.get() = value;
+        }
+    }
+}
+
+// SAFETY: COM thumbnail providers run in single-threaded apartment (STA)
+unsafe impl<T> Sync for ComCell<T> {}
+unsafe impl<T> Send for ComCell<T> {}
+
+#[implement(IThumbnailProvider, IInitializeWithItem)]
+pub struct ThumbnailProvider {
+    file_path: ComCell<Option<PathBuf>>,
+    file_ext: ComCell<Option<String>>,
+    should_provide: ComCell<bool>,
+}
+
+impl ThumbnailProvider {
+    pub fn new() -> Self {
+        dll_add_ref();
+        Self {
+            file_path: ComCell::new(None),
+            file_ext: ComCell::new(None),
+            should_provide: ComCell::new(false),
+        }
+    }
+}
+
+impl Default for ThumbnailProvider {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+
+impl Drop for ThumbnailProvider {
+    fn drop(&mut self) {
+        dll_release();
+    }
+}
+
+impl IInitializeWithItem_Impl for ThumbnailProvider_Impl {
+    fn Initialize(&self, psi: Ref<'_, IShellItem>, _grfmode: u32) -> windows::core::Result<()> {
+        let item = psi.ok()?;
+
+        unsafe {
+            let path_pwstr = item.GetDisplayName(SIGDN_FILESYSPATH)?;
+
+            let mut len = 0usize;
+            let mut ptr = path_pwstr.0;
+            while *ptr != 0 {
+                len += 1;
+                ptr = ptr.add(1);
+            }
+
+            let slice = std::slice::from_raw_parts(path_pwstr.0, len);
+            let path_str = String::from_utf16_lossy(slice);
+            let path = PathBuf::from(&path_str);
+
+            CoTaskMemFree(Some(path_pwstr.0 as *const c_void));
+
+            let is_default = is_readest_default_for_file(&path);
+            self.should_provide.set(is_default);
+
+            if !is_default {
+                return Ok(());
+            }
+
+            let ext = path
+                .extension()
+                .and_then(|e| e.to_str())
+                .map(|s| s.to_lowercase())
+                .unwrap_or_default();
+
+            self.file_path.set(Some(path));
+            self.file_ext.set(Some(ext));
+        }
+        Ok(())
+    }
+}
+
+impl IThumbnailProvider_Impl for ThumbnailProvider_Impl {
+    fn GetThumbnail(
+        &self,
+        cx: u32,
+        phbmp: *mut HBITMAP,
+        pdwalpha: *mut WTS_ALPHATYPE,
+    ) -> windows::core::Result<()> {
+        if !*self.should_provide.get() {
+            return Err(E_FAIL.into());
+        }
+
+        let path = self.file_path.get().as_ref().ok_or(E_FAIL)?;
+        let ext = self.file_ext.get().as_ref().ok_or(E_FAIL)?;
+
+        let png_bytes = cached_thumbnail_for_path(path, ext, cx).map_err(|_| E_FAIL)?;
+        let img = image::load_from_memory(&png_bytes).map_err(|_| E_FAIL)?;
+        let rgba = img.to_rgba8();
+        let (width, height) = (rgba.width(), rgba.height());
+
+        let bmi = BITMAPINFO {
+            bmiHeader: BITMAPINFOHEADER {
+                biSize: std::mem::size_of::<BITMAPINFOHEADER>() as u32,
+                biWidth: width as i32,
+                biHeight: -(height as i32),
+                biPlanes: 1,
+                biBitCount: 32,
+                biCompression: BI_RGB.0,
+                ..Default::default()
+            },
+            ..Default::default()
+        };
+
+        let mut bits: *mut c_void = std::ptr::null_mut();
+
+        unsafe {
+            let hbmp = CreateDIBSection(None, &bmi, DIB_RGB_COLORS, &mut bits, None, 0)
+                .map_err(|_| E_FAIL)?;
+            if bits.is_null() {
+                return Err(E_FAIL.into());
+            }
+
+            // RGBA -> BGRA
+            let dst =
+                std::slice::from_raw_parts_mut(bits as *mut u8, (width * height * 4) as usize);
+            let src = rgba.as_raw();
+            for i in 0..(width * height) as usize {
+                let si = i * 4;
+                dst[si] = src[si + 2]; // B
+                dst[si + 1] = src[si + 1]; // G
+                dst[si + 2] = src[si]; // R
+                dst[si + 3] = src[si + 3]; // A
+            }
+
+            *phbmp = hbmp;
+            *pdwalpha = WTSAT_ARGB;
+        }
+        Ok(())
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ClassFactory
+// ─────────────────────────────────────────────────────────────────────────────
+
+#[implement(IClassFactory)]
+pub struct ThumbnailProviderFactory;
+
+impl ThumbnailProviderFactory {
+    pub fn new() -> Self {
+        dll_add_ref();
+        Self
+    }
+}
+
+impl Default for ThumbnailProviderFactory {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+
+impl Drop for ThumbnailProviderFactory {
+    fn drop(&mut self) {
+        dll_release();
+    }
+}
+
+impl IClassFactory_Impl for ThumbnailProviderFactory_Impl {
+    fn CreateInstance(
+        &self,
+        punkouter: Ref<'_, IUnknown>,
+        riid: *const GUID,
+        ppvobject: *mut *mut c_void,
+    ) -> windows::core::Result<()> {
+        unsafe {
+            if ppvobject.is_null() {
+                return Err(E_INVALIDARG.into());
+            }
+            *ppvobject = std::ptr::null_mut();
+            if !punkouter.is_null() {
+                return Err(CLASS_E_NOAGGREGATION.into());
+            }
+
+            let provider: IThumbnailProvider = ThumbnailProvider::new().into();
+            provider.query(&*riid, ppvobject).ok()
+        }
+    }
+
+    fn LockServer(&self, flock: BOOL) -> windows::core::Result<()> {
+        if flock.as_bool() {
+            dll_add_ref();
+        } else {
+            dll_release();
+        }
+        Ok(())
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// DLL Exports
+// ─────────────────────────────────────────────────────────────────────────────
+
+#[no_mangle]
+pub extern "system" fn DllMain(hinstance: HMODULE, reason: u32, _reserved: *mut c_void) -> BOOL {
+    const DLL_PROCESS_ATTACH: u32 = 1;
+    if reason == DLL_PROCESS_ATTACH {
+        set_dll_module(hinstance);
+    }
+    BOOL::from(true)
+}
+
+#[no_mangle]
+pub extern "system" fn DllCanUnloadNow() -> HRESULT {
+    if DLL_REF_COUNT.load(Ordering::SeqCst) == 0 {
+        S_OK
+    } else {
+        S_FALSE
+    }
+}
+
+#[no_mangle]
+pub unsafe extern "system" fn DllGetClassObject(
+    rclsid: *const GUID,
+    riid: *const GUID,
+    ppv: *mut *mut c_void,
+) -> HRESULT {
+    if ppv.is_null() || rclsid.is_null() || riid.is_null() {
+        return E_INVALIDARG;
+    }
+    *ppv = std::ptr::null_mut();
+
+    if *rclsid != CLSID_READEST_THUMBNAIL {
+        return E_NOINTERFACE;
+    }
+    if *riid != IClassFactory::IID && *riid != IUnknown::IID {
+        return E_NOINTERFACE;
+    }
+
+    let factory: IClassFactory = ThumbnailProviderFactory::new().into();
+    factory.query(&*riid, ppv)
+}
+
+#[no_mangle]
+pub unsafe extern "system" fn DllRegisterServer() -> HRESULT {
+    match register_server_impl() {
+        Ok(()) => S_OK,
+        Err(e) => e,
+    }
+}
+
+#[no_mangle]
+pub unsafe extern "system" fn DllUnregisterServer() -> HRESULT {
+    let _ = unregister_server_impl();
+    S_OK
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Registry helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+fn get_dll_path() -> Option<String> {
+    let module = get_dll_module()?;
+    let mut buffer = [0u16; 260];
+    unsafe {
+        let len = GetModuleFileNameW(Some(module), &mut buffer);
+        if len == 0 {
+            None
+        } else {
+            Some(String::from_utf16_lossy(&buffer[..len as usize]))
+        }
+    }
+}
+
+fn clsid_string() -> String {
+    format!(
+        "{{{:08X}-{:04X}-{:04X}-{:02X}{:02X}-{:02X}{:02X}{:02X}{:02X}{:02X}{:02X}}}",
+        CLSID_READEST_THUMBNAIL.data1,
+        CLSID_READEST_THUMBNAIL.data2,
+        CLSID_READEST_THUMBNAIL.data3,
+        CLSID_READEST_THUMBNAIL.data4[0],
+        CLSID_READEST_THUMBNAIL.data4[1],
+        CLSID_READEST_THUMBNAIL.data4[2],
+        CLSID_READEST_THUMBNAIL.data4[3],
+        CLSID_READEST_THUMBNAIL.data4[4],
+        CLSID_READEST_THUMBNAIL.data4[5],
+        CLSID_READEST_THUMBNAIL.data4[6],
+        CLSID_READEST_THUMBNAIL.data4[7]
+    )
+}
+
+fn to_wide(s: &str) -> Vec<u16> {
+    s.encode_utf16().chain(std::iter::once(0)).collect()
+}
+
+unsafe fn set_reg_value(key: HKEY, name: &str, value: &str) -> Result<(), HRESULT> {
+    let name_w = to_wide(name);
+    let value_w = to_wide(value);
+    let bytes: &[u8] = std::slice::from_raw_parts(value_w.as_ptr() as *const u8, value_w.len() * 2);
+    if RegSetValueExW(key, PCWSTR(name_w.as_ptr()), Some(0), REG_SZ, Some(bytes)).is_err() {
+        Err(E_FAIL)
+    } else {
+        Ok(())
+    }
+}
+
+unsafe fn create_reg_key(parent: HKEY, subkey: &str) -> Result<HKEY, HRESULT> {
+    let subkey_w = to_wide(subkey);
+    let mut hkey = HKEY::default();
+    let result = RegCreateKeyExW(
+        parent,
+        PCWSTR(subkey_w.as_ptr()),
+        Some(0),
+        None,
+        REG_OPTION_NON_VOLATILE,
+        KEY_WRITE,
+        None,
+        &mut hkey,
+        None,
+    );
+    if result.is_err() {
+        Err(E_FAIL)
+    } else {
+        Ok(hkey)
+    }
+}
+
+unsafe fn register_server_impl() -> Result<(), HRESULT> {
+    let dll_path = get_dll_path().ok_or(E_FAIL)?;
+    let clsid = clsid_string();
+
+    // CLSID key
+    let clsid_key = create_reg_key(HKEY_CLASSES_ROOT, &format!("CLSID\\{}", clsid))?;
+    set_reg_value(clsid_key, "", "Readest Thumbnail Provider")?;
+
+    // CRITICAL: DisableProcessIsolation = 1
+    let disable_isolation_name = to_wide("DisableProcessIsolation");
+    let value: u32 = 1;
+    let _ = windows::Win32::System::Registry::RegSetValueExW(
+        clsid_key,
+        PCWSTR(disable_isolation_name.as_ptr()),
+        Some(0),
+        windows::Win32::System::Registry::REG_DWORD,
+        Some(std::slice::from_raw_parts(
+            &value as *const u32 as *const u8,
+            4,
+        )),
+    );
+
+    let inproc_key = create_reg_key(clsid_key, "InprocServer32")?;
+    set_reg_value(inproc_key, "", &dll_path)?;
+    set_reg_value(inproc_key, "ThreadingModel", "Apartment")?;
+    let _ = RegCloseKey(inproc_key);
+    let _ = RegCloseKey(clsid_key);
+
+    // Register ShellEx thumbnail handler for each extension
+    for ext in SUPPORTED_EXTENSIONS {
+        let ext_shellex_path =
+            format!("{}\\ShellEx\\{{e357fccd-a995-4576-b01f-234630154e96}}", ext);
+        if let Ok(ext_shellex_key) = create_reg_key(HKEY_CLASSES_ROOT, &ext_shellex_path) {
+            let _ = set_reg_value(ext_shellex_key, "", &clsid);
+            let _ = RegCloseKey(ext_shellex_key);
+        }
+    }
+    Ok(())
+}
+
+unsafe fn unregister_server_impl() -> Result<(), HRESULT> {
+    let clsid = clsid_string();
+    let clsid_path = to_wide(&format!("CLSID\\{}", clsid));
+    let _ = RegDeleteTreeW(HKEY_CLASSES_ROOT, PCWSTR(clsid_path.as_ptr()));
+
+    for ext in SUPPORTED_EXTENSIONS {
+        let ext_path = to_wide(&format!(
+            "{}\\ShellEx\\{{e357fccd-a995-4576-b01f-234630154e96}}",
+            ext
+        ));
+        let _ = RegDeleteTreeW(HKEY_CLASSES_ROOT, PCWSTR(ext_path.as_ptr()));
+    }
+    Ok(())
+}

apps/readest-app/extensions/windows-thumbnail/src/extraction.rs

@@ -0,0 +1,648 @@
+/// Cover image extraction for various eBook formats
+///
+/// Supports: EPUB, MOBI/AZW3/KF8, FB2, CBZ/CBR, TXT
+use anyhow::{anyhow, Result};
+use base64::engine::general_purpose;
+use base64::Engine as _;
+use directories_next::ProjectDirs;
+use image::{imageops, DynamicImage, Rgba};
+use md5::Context;
+use once_cell::sync::Lazy;
+use std::io::{Cursor, Read, Seek, SeekFrom};
+use std::path::Path;
+use zip::ZipArchive;
+
+/// Thumbnail cache directory (per-user)
+static CACHE_DIR: Lazy<Option<std::path::PathBuf>> = Lazy::new(|| {
+    ProjectDirs::from("app", "Readest", "").map(|pd| {
+        let dir = pd.cache_dir().join("thumbnails");
+        let _ = std::fs::create_dir_all(&dir);
+        dir
+    })
+});
+
+// ─────────────────────────────────────────────────────────────────────────────
+// EPUB extraction
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Extract cover image bytes from an EPUB file.
+pub fn extract_epub_cover_bytes<R: Read + Seek>(reader: R) -> Result<Vec<u8>> {
+    let mut archive = ZipArchive::new(reader)?;
+
+    // Pass 1: Look for files with "cover" in the name
+    let mut candidates: Vec<(usize, String, u64)> = Vec::new();
+    for i in 0..archive.len() {
+        let file = archive.by_index(i)?;
+        let name = file.name().to_lowercase();
+        let size = file.size();
+        drop(file);
+
+        if is_image_extension(&name) && (name.contains("cover") || name.contains("front")) {
+            candidates.push((i, name, size));
+        }
+    }
+
+    // Sort by priority: exact "cover" match first, then by size
+    if !candidates.is_empty() {
+        candidates.sort_by(|a, b| {
+            let a_exact = a.1.contains("cover.") || a.1.ends_with("cover");
+            let b_exact = b.1.contains("cover.") || b.1.ends_with("cover");
+            match (a_exact, b_exact) {
+                (true, false) => std::cmp::Ordering::Less,
+                (false, true) => std::cmp::Ordering::Greater,
+                _ => b.2.cmp(&a.2),
+            }
+        });
+
+        let idx = candidates[0].0;
+        let mut file = archive.by_index(idx)?;
+        let mut buf = Vec::new();
+        file.read_to_end(&mut buf)?;
+        return Ok(buf);
+    }
+
+    // Pass 2: Parse container.xml to find OPF, then parse OPF for cover
+    let container_xml = read_zip_file_to_string(&mut archive, "META-INF/container.xml");
+    if let Ok(xml) = container_xml {
+        if let Some(rootfile) = extract_attribute(&xml, "rootfile", "full-path") {
+            let opf_content = read_zip_file_to_string(&mut archive, &rootfile);
+            if let Ok(opf) = opf_content {
+                if let Some(cover_id) = find_cover_id_in_opf(&opf) {
+                    if let Some(href) = find_href_by_id_in_opf(&opf, &cover_id) {
+                        let base = Path::new(&rootfile).parent().unwrap_or(Path::new(""));
+                        let cover_path = base.join(&href).to_string_lossy().replace('\\', "/");
+                        if let Ok(bytes) = read_zip_file_to_bytes(&mut archive, &cover_path) {
+                            return Ok(bytes);
+                        }
+                    }
+                }
+                if let Some(href) = find_first_image_in_manifest(&opf) {
+                    let base = Path::new(&rootfile).parent().unwrap_or(Path::new(""));
+                    let cover_path = base.join(&href).to_string_lossy().replace('\\', "/");
+                    if let Ok(bytes) = read_zip_file_to_bytes(&mut archive, &cover_path) {
+                        return Ok(bytes);
+                    }
+                }
+            }
+        }
+    }
+
+    // Pass 3: Just grab the largest image file
+    let mut largest: Option<(usize, u64)> = None;
+    for i in 0..archive.len() {
+        let file = archive.by_index(i)?;
+        let name = file.name().to_lowercase();
+        let size = file.size();
+        drop(file);
+
+        if is_image_extension(&name) && (largest.is_none() || size > largest.unwrap().1) {
+            largest = Some((i, size));
+        }
+    }
+
+    if let Some((idx, _)) = largest {
+        let mut file = archive.by_index(idx)?;
+        let mut buf = Vec::new();
+        file.read_to_end(&mut buf)?;
+        return Ok(buf);
+    }
+
+    Err(anyhow!("No cover image found in EPUB"))
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// MOBI/AZW3/KF8 extraction
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Extract cover image from MOBI/AZW3/KF8 files.
+pub fn extract_mobi_cover_bytes<R: Read + Seek>(mut reader: R) -> Result<Vec<u8>> {
+    let mut header = [0u8; 78];
+    reader.read_exact(&mut header)?;
+
+    if &header[60..68] != b"BOOKMOBI" {
+        return Err(anyhow!("Not a valid MOBI file"));
+    }
+
+    let num_records = u16::from_be_bytes([header[76], header[77]]) as usize;
+
+    let mut record_offsets: Vec<u32> = Vec::with_capacity(num_records);
+    for _ in 0..num_records {
+        let mut rec = [0u8; 8];
+        reader.read_exact(&mut rec)?;
+        record_offsets.push(u32::from_be_bytes([rec[0], rec[1], rec[2], rec[3]]));
+    }
+
+    if record_offsets.is_empty() {
+        return Err(anyhow!("No records in MOBI file"));
+    }
+
+    reader.seek(SeekFrom::Start(record_offsets[0] as u64))?;
+    let mut mobi_header = [0u8; 256];
+    reader.read_exact(&mut mobi_header)?;
+
+    if &mobi_header[16..20] != b"MOBI" {
+        return Err(anyhow!("Invalid MOBI header"));
+    }
+
+    let header_length = u32::from_be_bytes([
+        mobi_header[20],
+        mobi_header[21],
+        mobi_header[22],
+        mobi_header[23],
+    ]) as usize;
+
+    let exth_flags = u32::from_be_bytes([
+        mobi_header[128],
+        mobi_header[129],
+        mobi_header[130],
+        mobi_header[131],
+    ]);
+    if exth_flags & 0x40 == 0 {
+        return Err(anyhow!("No EXTH header in MOBI file"));
+    }
+
+    let exth_offset = record_offsets[0] as u64 + 16 + header_length as u64;
+    reader.seek(SeekFrom::Start(exth_offset))?;
+
+    let mut exth_magic = [0u8; 4];
+    reader.read_exact(&mut exth_magic)?;
+    if &exth_magic != b"EXTH" {
+        return Err(anyhow!("EXTH header not found"));
+    }
+
+    let mut exth_len_bytes = [0u8; 4];
+    reader.read_exact(&mut exth_len_bytes)?;
+
+    let mut exth_count_bytes = [0u8; 4];
+    reader.read_exact(&mut exth_count_bytes)?;
+    let exth_count = u32::from_be_bytes(exth_count_bytes) as usize;
+
+    let mut cover_offset: Option<u32> = None;
+    let first_img_idx = u32::from_be_bytes([
+        mobi_header[108],
+        mobi_header[109],
+        mobi_header[110],
+        mobi_header[111],
+    ]);
+
+    for _ in 0..exth_count {
+        let mut rec_header = [0u8; 8];
+        if reader.read_exact(&mut rec_header).is_err() {
+            break;
+        }
+        let rec_type =
+            u32::from_be_bytes([rec_header[0], rec_header[1], rec_header[2], rec_header[3]]);
+        let rec_len =
+            u32::from_be_bytes([rec_header[4], rec_header[5], rec_header[6], rec_header[7]])
+                as usize;
+
+        let data_len = rec_len.saturating_sub(8);
+        let mut data = vec![0u8; data_len];
+        if reader.read_exact(&mut data).is_err() {
+            break;
+        }
+
+        if rec_type == 201 && data_len >= 4 {
+            cover_offset = Some(u32::from_be_bytes([data[0], data[1], data[2], data[3]]));
+        }
+    }
+
+    let cover_record_idx = if let Some(offset) = cover_offset {
+        first_img_idx + offset
+    } else {
+        first_img_idx
+    };
+
+    if cover_record_idx as usize >= record_offsets.len() {
+        return Err(anyhow!("Cover record index out of bounds"));
+    }
+
+    let start = record_offsets[cover_record_idx as usize] as u64;
+    let end = if (cover_record_idx as usize + 1) < record_offsets.len() {
+        record_offsets[cover_record_idx as usize + 1] as u64
+    } else {
+        reader.seek(SeekFrom::End(0))?;
+        reader.stream_position()?
+    };
+
+    let len = (end - start) as usize;
+    reader.seek(SeekFrom::Start(start))?;
+    let mut cover_data = vec![0u8; len];
+    reader.read_exact(&mut cover_data)?;
+
+    if cover_data.starts_with(&[0xFF, 0xD8, 0xFF])
+        || cover_data.starts_with(&[0x89, 0x50, 0x4E, 0x47])
+        || cover_data.starts_with(b"GIF")
+    {
+        return Ok(cover_data);
+    }
+
+    Err(anyhow!("No valid cover image found in MOBI"))
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CBZ extraction
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Extract cover image from CBZ (comic book ZIP) file.
+pub fn extract_cbz_cover_bytes<R: Read + Seek>(reader: R) -> Result<Vec<u8>> {
+    let mut archive = ZipArchive::new(reader)?;
+
+    let mut images: Vec<(usize, String)> = Vec::new();
+    for i in 0..archive.len() {
+        let file = archive.by_index(i)?;
+        let name = file.name().to_string();
+        drop(file);
+
+        if is_image_extension(&name.to_lowercase()) {
+            images.push((i, name));
+        }
+    }
+
+    images.sort_by(|a, b| a.1.cmp(&b.1));
+
+    if let Some((idx, _)) = images.first() {
+        let mut file = archive.by_index(*idx)?;
+        let mut buf = Vec::new();
+        file.read_to_end(&mut buf)?;
+        return Ok(buf);
+    }
+
+    Err(anyhow!("No images found in CBZ"))
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// FB2 extraction
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Extract cover image from FB2 (FictionBook) file.
+pub fn extract_fb2_cover_bytes<R: Read>(mut reader: R) -> Result<Vec<u8>> {
+    let mut content = String::new();
+    reader.read_to_string(&mut content)?;
+
+    let cover_id = if let Some(start) = content.find("<coverpage>") {
+        let end = content[start..].find("</coverpage>").unwrap_or(500);
+        let coverpage = &content[start..start + end];
+        if let Some(href_pos) = coverpage.find("href=\"#") {
+            let id_start = href_pos + 7;
+            let id_end = coverpage[id_start..].find('"').unwrap_or(50);
+            Some(coverpage[id_start..id_start + id_end].to_string())
+        } else if let Some(href_pos) = coverpage.find("l:href=\"#") {
+            let id_start = href_pos + 9;
+            let id_end = coverpage[id_start..].find('"').unwrap_or(50);
+            Some(coverpage[id_start..id_start + id_end].to_string())
+        } else {
+            None
+        }
+    } else {
+        None
+    };
+
+    let search_pattern = if let Some(ref id) = cover_id {
+        format!("<binary id=\"{}\"", id)
+    } else {
+        "<binary".to_string()
+    };
+
+    if let Some(pos) = content.find(&search_pattern) {
+        if let Some(tag_end) = content[pos..].find('>') {
+            let data_start = pos + tag_end + 1;
+            if let Some(data_end) = content[data_start..].find("</binary>") {
+                let b64_data = content[data_start..data_start + data_end].trim();
+                let b64_clean: String = b64_data.chars().filter(|c| !c.is_whitespace()).collect();
+                let bytes = general_purpose::STANDARD.decode(&b64_clean)?;
+                return Ok(bytes);
+            }
+        }
+    }
+
+    if cover_id.is_some() {
+        if let Some(pos) = content.find("<binary") {
+            if let Some(tag_end) = content[pos..].find('>') {
+                let data_start = pos + tag_end + 1;
+                if let Some(data_end) = content[data_start..].find("</binary>") {
+                    let b64_data = content[data_start..data_start + data_end].trim();
+                    let b64_clean: String =
+                        b64_data.chars().filter(|c| !c.is_whitespace()).collect();
+                    let bytes = general_purpose::STANDARD.decode(&b64_clean)?;
+                    return Ok(bytes);
+                }
+            }
+        }
+    }
+
+    Err(anyhow!("No cover image found in FB2"))
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// TXT "cover" (placeholder)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Generate a placeholder thumbnail for TXT files.
+pub fn extract_txt_cover_bytes<R: Read>(mut reader: R, size: u32) -> Result<Vec<u8>> {
+    let mut buf = vec![0u8; 4096];
+    let _n = reader.read(&mut buf)?;
+
+    let mut img = image::RgbaImage::from_pixel(size, size, Rgba([245, 245, 245, 255]));
+
+    for x in 0..size {
+        img.put_pixel(x, 0, Rgba([200, 200, 200, 255]));
+        img.put_pixel(x, size - 1, Rgba([200, 200, 200, 255]));
+    }
+    for y in 0..size {
+        img.put_pixel(0, y, Rgba([200, 200, 200, 255]));
+        img.put_pixel(size - 1, y, Rgba([200, 200, 200, 255]));
+    }
+
+    let mut out = Vec::new();
+    DynamicImage::ImageRgba8(img).write_to(&mut Cursor::new(&mut out), image::ImageFormat::Png)?;
+    Ok(out)
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Unified extraction by extension
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Extract cover image bytes based on file extension.
+pub fn extract_cover_bytes_by_ext(path: &Path, ext: &str) -> Result<Vec<u8>> {
+    let file = std::fs::File::open(path)?;
+    match ext.to_lowercase().as_str() {
+        "epub" => extract_epub_cover_bytes(file),
+        "mobi" | "azw" | "azw3" | "kf8" | "prc" => extract_mobi_cover_bytes(file),
+        "cbz" | "cbr" => extract_cbz_cover_bytes(file),
+        "fb2" => extract_fb2_cover_bytes(file),
+        "txt" => extract_txt_cover_bytes(file, 256),
+        _ => Err(anyhow!("Unsupported format: {}", ext)),
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Thumbnail creation with overlay
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Create a thumbnail from cover image bytes with Readest icon overlay.
+pub fn create_thumbnail_with_overlay(cover_bytes: &[u8], requested_size: u32) -> Result<Vec<u8>> {
+    let img = image::load_from_memory(cover_bytes)?;
+    let thumbnail = img.thumbnail(requested_size, requested_size);
+
+    let overlay_img = load_overlay_icon();
+
+    let mut base = thumbnail.to_rgba8();
+    let (base_w, base_h) = (base.width(), base.height());
+
+    if let Some(ov) = overlay_img {
+        let overlay_size = (requested_size / 5).clamp(24, 48);
+        let ov_resized = ov.resize(overlay_size, overlay_size, imageops::FilterType::Lanczos3);
+        let ovb = ov_resized.to_rgba8();
+        let (ov_w, ov_h) = (ovb.width(), ovb.height());
+
+        let x = base_w.saturating_sub(ov_w + 4);
+        let y = base_h.saturating_sub(ov_h + 4);
+
+        for oy in 0..ov_h {
+            for ox in 0..ov_w {
+                let dst_x = x + ox;
+                let dst_y = y + oy;
+
+                if dst_x < base_w && dst_y < base_h {
+                    let src_pixel = ovb.get_pixel(ox, oy);
+                    let alpha = src_pixel.0[3] as f32 / 255.0;
+
+                    if alpha > 0.0 {
+                        let dst_pixel = base.get_pixel(dst_x, dst_y);
+                        let mut result = dst_pixel.0;
+
+                        for c in 0..3 {
+                            let fg = src_pixel.0[c] as f32;
+                            let bg = result[c] as f32;
+                            result[c] = (fg * alpha + bg * (1.0 - alpha)) as u8;
+                        }
+                        result[3] = 255;
+
+                        base.put_pixel(dst_x, dst_y, Rgba(result));
+                    }
+                }
+            }
+        }
+    }
+
+    let mut out = Vec::new();
+    DynamicImage::ImageRgba8(base).write_to(&mut Cursor::new(&mut out), image::ImageFormat::Png)?;
+    Ok(out)
+}
+
+/// Load the Readest overlay icon.
+fn load_overlay_icon() -> Option<DynamicImage> {
+    // Try embedded icon
+    let icon_bytes = include_bytes!("../../../public/icon.png");
+    if let Ok(img) = image::load_from_memory(icon_bytes) {
+        return Some(img);
+    }
+
+    // Fallback: try loading from filesystem
+    if let Ok(exe) = std::env::current_exe() {
+        let candidates = [
+            exe.parent().map(|p| p.join("icon.png")),
+            exe.parent().map(|p| p.join("resources").join("icon.png")),
+            exe.parent()
+                .and_then(|p| p.parent())
+                .map(|p| p.join("resources").join("icon.png")),
+        ];
+
+        for candidate in candidates.into_iter().flatten() {
+            if candidate.exists() {
+                if let Ok(bytes) = std::fs::read(&candidate) {
+                    if let Ok(img) = image::load_from_memory(&bytes) {
+                        return Some(img);
+                    }
+                }
+            }
+        }
+    }
+
+    None
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Caching
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Generate a thumbnail with disk caching.
+pub fn cached_thumbnail_for_path(path: &Path, ext: &str, size: u32) -> Result<Vec<u8>> {
+    // Compute cache key by hashing file parts for stability without loading entire file
+    let mut hasher = Context::new();
+    hasher.consume(ext.as_bytes());
+    hasher.consume(&size.to_le_bytes());
+
+    let file = std::fs::File::open(path)?;
+    let metadata = file.metadata()?;
+    let file_len = metadata.len();
+
+    // Read partial chunks like the TypeScript partialMD5 implementation
+    const STEP: u64 = 1024;
+    const SIZE: u64 = 1024;
+    let mut file = file;
+
+    for i in -1i32..=10 {
+        let pos = if i == -1 {
+            256u64
+        } else {
+            STEP << (2 * i as u32)
+        };
+        let start = pos.min(file_len);
+        let end = (start + SIZE).min(file_len);
+
+        if start >= file_len {
+            break;
+        }
+
+        file.seek(SeekFrom::Start(start))?;
+        let mut buf = vec![0u8; (end - start) as usize];
+        file.read_exact(&mut buf)?;
+        hasher.consume(&buf);
+    }
+
+    let digest = hasher.finalize();
+    let key = format!("{:x}.png", digest);
+
+    if let Some(ref dir) = *CACHE_DIR {
+        let cache_path = dir.join(&key);
+        if cache_path.exists() {
+            if let Ok(cached) = std::fs::read(&cache_path) {
+                return Ok(cached);
+            }
+        }
+    }
+
+    let cover = extract_cover_bytes_by_ext(path, ext)?;
+    let thumbnail = create_thumbnail_with_overlay(&cover, size)?;
+
+    if let Some(ref dir) = *CACHE_DIR {
+        let cache_path = dir.join(&key);
+        let _ = std::fs::write(&cache_path, &thumbnail);
+    }
+
+    Ok(thumbnail)
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Helper functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+fn is_image_extension(name: &str) -> bool {
+    name.ends_with(".jpg")
+        || name.ends_with(".jpeg")
+        || name.ends_with(".png")
+        || name.ends_with(".gif")
+        || name.ends_with(".webp")
+        || name.ends_with(".bmp")
+}
+
+fn read_zip_file_to_string<R: Read + Seek>(
+    archive: &mut ZipArchive<R>,
+    name: &str,
+) -> Result<String> {
+    let mut file = archive.by_name(name)?;
+    let mut content = String::new();
+    file.read_to_string(&mut content)?;
+    Ok(content)
+}
+
+fn read_zip_file_to_bytes<R: Read + Seek>(
+    archive: &mut ZipArchive<R>,
+    name: &str,
+) -> Result<Vec<u8>> {
+    let mut file = archive.by_name(name)?;
+    let mut buf = Vec::new();
+    file.read_to_end(&mut buf)?;
+    Ok(buf)
+}
+
+fn extract_attribute(xml: &str, tag: &str, attr: &str) -> Option<String> {
+    let pattern = format!("<{}", tag);
+    if let Some(tag_pos) = xml.find(&pattern) {
+        let tag_end = xml[tag_pos..].find('>').unwrap_or(500) + tag_pos;
+        let tag_content = &xml[tag_pos..tag_end];
+
+        let attr_pattern = format!("{}=\"", attr);
+        if let Some(attr_pos) = tag_content.find(&attr_pattern) {
+            let value_start = attr_pos + attr_pattern.len();
+            if let Some(value_end) = tag_content[value_start..].find('"') {
+                return Some(tag_content[value_start..value_start + value_end].to_string());
+            }
+        }
+    }
+    None
+}
+
+fn find_cover_id_in_opf(opf: &str) -> Option<String> {
+    if let Some(pos) = opf.find("name=\"cover\"") {
+        let window_start = pos.saturating_sub(50);
+        let window_end = (pos + 100).min(opf.len());
+        let window = &opf[window_start..window_end];
+
+        if let Some(content_pos) = window.find("content=\"") {
+            let start = content_pos + 9;
+            if let Some(end) = window[start..].find('"') {
+                return Some(window[start..start + end].to_string());
+            }
+        }
+    }
+
+    if let Some(pos) = opf.find("properties=\"cover-image\"") {
+        let window_start = pos.saturating_sub(200);
+        let window_end = pos;
+        let window = &opf[window_start..window_end];
+
+        if let Some(id_pos) = window.rfind("id=\"") {
+            let start = id_pos + 4;
+            if let Some(end) = window[start..].find('"') {
+                return Some(window[start..start + end].to_string());
+            }
+        }
+    }
+
+    None
+}
+
+fn find_href_by_id_in_opf(opf: &str, id: &str) -> Option<String> {
+    let pattern = format!("id=\"{}\"", id);
+    if let Some(pos) = opf.find(&pattern) {
+        let window_start = pos.saturating_sub(10);
+        let window_end = (pos + 200).min(opf.len());
+        let window = &opf[window_start..window_end];
+
+        if let Some(href_pos) = window.find("href=\"") {
+            let start = href_pos + 6;
+            if let Some(end) = window[start..].find('"') {
+                return Some(window[start..start + end].to_string());
+            }
+        }
+    }
+    None
+}
+
+fn find_first_image_in_manifest(opf: &str) -> Option<String> {
+    let manifest_start = opf.find("<manifest")?;
+    let manifest_end = opf[manifest_start..]
+        .find("</manifest>")
+        .map(|e| manifest_start + e)?;
+    let manifest = &opf[manifest_start..manifest_end];
+
+    for media_type in ["image/jpeg", "image/png", "image/gif", "image/webp"] {
+        let pattern = format!("media-type=\"{}\"", media_type);
+        if let Some(pos) = manifest.find(&pattern) {
+            let window_start = pos.saturating_sub(200);
+            let window = &manifest[window_start..pos];
+
+            if let Some(href_pos) = window.rfind("href=\"") {
+                let start = href_pos + 6;
+                if let Some(end) = window[start..].find('"') {
+                    return Some(window[start..start + end].to_string());
+                }
+            }
+        }
+    }
+
+    None
+}

apps/readest-app/extensions/windows-thumbnail/src/mod.rs

@@ -0,0 +1,13 @@
+//! Windows Thumbnail Provider for Readest
+//!
+//! This module provides Windows Explorer thumbnail support for eBook files.
+//! Thumbnails are only shown when Readest is set as the default application.
+//!
+//! Supported formats: EPUB, MOBI, AZW, AZW3, KF8, FB2, CBZ, CBR
+
+#![allow(non_snake_case)]
+
+mod com_provider;
+mod extraction;
+
+pub use extraction::*;

apps/readest-app/i18next-scanner.config.js

@@ -12,11 +12,14 @@ module.exports = {
       'de',
       'ja',
       'es',
+      'fa',
       'fr',
       'it',
       'el',
       'ko',
       'uk',
+      'nl',
+      'sv',
       'pl',
       'pt',
       'ru',
@@ -24,7 +27,13 @@ module.exports = {
       'hi',
       'id',
       'vi',
+      'ms',
       'ar',
+      'th',
+      'bo',
+      'bn',
+      'ta',
+      'si',
       'zh-CN',
       'zh-TW',
     ],

apps/readest-app/next.config.mjs

@@ -1,13 +1,22 @@
-import withPWAInit from '@ducanh2912/next-pwa';
+import withSerwistInit from '@serwist/next';
+import withBundleAnalyzer from '@next/bundle-analyzer';
 
 const isDev = process.env['NODE_ENV'] === 'development';
 const appPlatform = process.env['NEXT_PUBLIC_APP_PLATFORM'];
 
+if (isDev) {
+  const { initOpenNextCloudflareForDev } = await import('@opennextjs/cloudflare');
+  initOpenNextCloudflareForDev();
+}
+
+const exportOutput = appPlatform !== 'web' && !isDev;
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   // Ensure Next.js uses SSG instead of SSR
   // https://nextjs.org/docs/pages/building-your-application/deploying/static-exports
-  output: appPlatform === 'web' || isDev ? undefined : 'export',
+  output: exportOutput ? 'export' : undefined,
+  pageExtensions: exportOutput ? ['jsx', 'tsx'] : ['js', 'jsx', 'ts', 'tsx'],
   // Note: This feature is required to use the Next.js Image component in SSG mode.
   // See https://nextjs.org/docs/messages/export-image-api for different workarounds.
   images: {
@@ -17,6 +26,39 @@ const nextConfig = {
   // Configure assetPrefix or else the server won't properly resolve your assets.
   assetPrefix: '',
   reactStrictMode: true,
+  serverExternalPackages: ['isows'],
+  webpack: (config) => {
+    config.resolve.alias = {
+      ...config.resolve.alias,
+      nunjucks: 'nunjucks/browser/nunjucks.js',
+    };
+    return config;
+  },
+  turbopack: {
+    resolveAlias: {
+      nunjucks: 'nunjucks/browser/nunjucks.js',
+    },
+  },
+  transpilePackages: [
+    'ai',
+    'ai-sdk-ollama',
+    '@ai-sdk/react',
+    '@assistant-ui/react',
+    '@assistant-ui/react-ai-sdk',
+    '@assistant-ui/react-markdown',
+    'streamdown',
+    ...(isDev
+      ? []
+      : [
+          'i18next-browser-languagedetector',
+          'react-i18next',
+          'i18next',
+          '@tauri-apps',
+          'highlight.js',
+          'foliate-js',
+          'marked',
+        ]),
+  ],
   async headers() {
     return [
       {
@@ -28,23 +70,37 @@ const nextConfig = {
           },
         ],
       },
+      {
+        source: '/_next/static/:path*',
+        headers: [
+          {
+            key: 'Cache-Control',
+            value: isDev
+              ? 'public, max-age=0, must-revalidate'
+              : 'public, max-age=31536000, immutable',
+          },
+        ],
+      },
     ];
   },
 };
 
-const withPWA = withPWAInit({
-  dest: 'public',
-  disable: isDev || appPlatform !== 'web',
-  cacheOnFrontEndNav: true,
-  aggressiveFrontEndNavCaching: true,
-  reloadOnOnline: true,
-  swcMinify: true,
-  fallbacks: {
-    document: '/offline',
-  },
-  workboxOptions: {
-    disableDevLogs: true,
-  },
+const pwaDisabled = isDev || appPlatform !== 'web';
+
+const withPWA = pwaDisabled
+  ? (config) => config
+  : withSerwistInit({
+      swSrc: 'src/sw.ts',
+      swDest: 'public/sw.js',
+      cacheOnNavigation: true,
+      reloadOnOnline: true,
+      disable: false,
+      register: true,
+      scope: '/',
+    });
+
+const withAnalyzer = withBundleAnalyzer({
+  enabled: process.env.ANALYZE === 'true',
 });
 
-export default withPWA(nextConfig);
+export default withPWA(withAnalyzer(nextConfig));

apps/readest-app/open-next.config.ts

@@ -1,29 +1,6 @@
-// @ts-nocheck
-// default open-next.config.ts file created by @opennextjs/cloudflare
+import { defineCloudflareConfig } from '@opennextjs/cloudflare';
+import r2IncrementalCache from '@opennextjs/cloudflare/overrides/incremental-cache/r2-incremental-cache';
 
-import type { OpenNextConfig } from '@opennextjs/aws/types/open-next.js';
-import cache from '@opennextjs/cloudflare/kv-cache';
-
-const config: OpenNextConfig = {
-  default: {
-    override: {
-      wrapper: 'cloudflare-node',
-      converter: 'edge',
-      // set `incrementalCache` to "dummy" to disable KV cache
-      incrementalCache: async () => cache,
-      tagCache: 'dummy',
-      queue: 'dummy',
-    },
-  },
-
-  middleware: {
-    external: true,
-    override: {
-      wrapper: 'cloudflare-edge',
-      converter: 'edge',
-      proxyExternalRequest: 'fetch',
-    },
-  },
-};
-
-export default config;
+export default defineCloudflareConfig({
+  incrementalCache: r2IncrementalCache,
+});

apps/readest-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readest/readest-app",
-  "version": "0.9.23",
+  "version": "0.9.99",
   "private": true,
   "scripts": {
     "dev": "dotenv -e .env.tauri -- next dev",
@@ -9,17 +9,26 @@
     "dev-web": "dotenv -e .env.web -- next dev",
     "build-web": "dotenv -e .env.web -- next build",
     "start-web": "dotenv -e .env.web -- next start",
+    "build-tauri": "dotenv -e .env.tauri -- next build",
     "i18n:extract": "i18next-scanner",
-    "lint": "next lint",
+    "lint": "eslint .",
+    "test": "dotenv -e .env -e .env.test.local vitest",
     "tauri": "tauri",
-    "prepare-public-vendor": "mkdirp ./public/vendor/pdfjs",
-    "copy-pdfjs-js": "cpx \"../../packages/foliate-js/node_modules/pdfjs-dist/legacy/build/{pdf.worker.min.mjs,pdf.mjs,pdf.d.mts}\" ./public/vendor/pdfjs",
+    "clippy": "cargo clippy -p Readest --no-deps -- -D warnings",
+    "format": "pnpm -w format",
+    "format:check": "pnpm -w format:check",
+    "prepare-public-vendor": "mkdirp ./public/vendor/pdfjs ./public/vendor/simplecc",
+    "copy-pdfjs-js": "cpx \"../../packages/foliate-js/node_modules/pdfjs-dist/legacy/build/{pdf.worker.min.mjs,pdf.min.mjs,pdf.d.mts}\" ./public/vendor/pdfjs",
+    "copy-pdfjs-wasm": "cpx \"../../packages/foliate-js/node_modules/pdfjs-dist/wasm/{openjpeg.wasm,qcms_bg.wasm}\" ./public/vendor/pdfjs",
     "copy-pdfjs-fonts": "cpx \"../../packages/foliate-js/node_modules/pdfjs-dist/{cmaps,standard_fonts}/*\" ./public/vendor/pdfjs",
     "copy-flatten-pdfjs-annotation-layer-css": "npx postcss \"../../packages/foliate-js/vendor/pdfjs/annotation_layer_builder.css\" --no-map -u postcss-nested > ./public/vendor/pdfjs/annotation_layer_builder.css",
     "copy-flatten-pdfjs-text-layer-css": "npx postcss \"../../packages/foliate-js/vendor/pdfjs/text_layer_builder.css\" --no-map -u postcss-nested > ./public/vendor/pdfjs/text_layer_builder.css",
     "copy-flatten-pdfjs-css": "pnpm copy-flatten-pdfjs-annotation-layer-css && pnpm copy-flatten-pdfjs-text-layer-css",
-    "copy-pdfjs": "pnpm copy-pdfjs-js && pnpm copy-pdfjs-fonts && pnpm copy-flatten-pdfjs-css",
+    "copy-pdfjs": "pnpm copy-pdfjs-js && pnpm copy-pdfjs-wasm && pnpm copy-pdfjs-fonts && pnpm copy-flatten-pdfjs-css",
+    "copy-simplecc": "cpx \"../../packages/simplecc-wasm/dist/web/*\" ./public/vendor/simplecc",
     "setup-pdfjs": "pnpm prepare-public-vendor && pnpm copy-pdfjs",
+    "setup-simplecc": "pnpm prepare-public-vendor && pnpm copy-simplecc",
+    "setup-vendors": "pnpm setup-pdfjs && pnpm setup-simplecc",
     "build-win-x64": "dotenv -e .env.tauri.local -- tauri build --target i686-pc-windows-msvc --bundles nsis",
     "build-win-arm64": "dotenv -e .env.tauri.local -- tauri build --target aarch64-pc-windows-msvc --bundles nsis",
     "build-linux-x64": "dotenv -e .env.tauri.local -- tauri build --target x86_64-unknown-linux-gnu --bundles appimage",
@@ -30,75 +39,160 @@
     "build-ios-appstore": "dotenv -e .env.ios-appstore.local -- tauri ios build --export-method app-store-connect",
     "release-macos-universial-appstore": "dotenv -e .env.tauri.local -e .env.apple-appstore.local -- bash scripts/release-mac-appstore.sh",
     "release-ios-appstore": "dotenv -e .env.ios-appstore.local -- bash scripts/release-ios-appstore.sh",
-    "preview": "NEXT_PUBLIC_APP_PLATFORM=web opennextjs-cloudflare && wrangler dev",
-    "deploy": "NEXT_PUBLIC_APP_PLATFORM=web opennextjs-cloudflare && wrangler deploy",
-    "cf-typegen": "wrangler types --env-interface CloudflareEnv cloudflare-env.d.ts"
+    "release-google-play": "dotenv -e .env.google-play.local -- bash scripts/release-google-play.sh",
+    "config-wrangler": "sed -i \"s/\\${TRANSLATIONS_KV_ID}/$TRANSLATIONS_KV_ID/g\" wrangler.toml",
+    "preview": "pnpm patch-build-webpack && NEXT_PUBLIC_APP_PLATFORM=web opennextjs-cloudflare build && pnpm restore-build-original && opennextjs-cloudflare preview --ip 0.0.0.0 --port 3001",
+    "deploy": "pnpm patch-build-webpack && NEXT_PUBLIC_APP_PLATFORM=web opennextjs-cloudflare build && pnpm restore-build-original && opennextjs-cloudflare deploy",
+    "upload": "pnpm patch-build-webpack && NEXT_PUBLIC_APP_PLATFORM=web opennextjs-cloudflare build && pnpm restore-build-original && opennextjs-cloudflare upload",
+    "cf-typegen": "wrangler types --env-interface CloudflareEnv cloudflare-env.d.ts",
+    "patch-build-webpack": "if [ \"$(uname)\" = \"Darwin\" ]; then sed -i '' 's/next build\"/next build --webpack\"/' package.json; else sed -i 's/next build\"/next build --webpack\"/' package.json; fi",
+    "restore-build-original": "if [ \"$(uname)\" = \"Darwin\" ]; then sed -i '' 's/next build --webpack\"/next build\"/' package.json; else sed -i 's/next build --webpack\"/next build\"/' package.json; fi",
+    "update-metadata": "bash ./scripts/sync-release-notes.sh release-notes.json ../../data/metainfo/appdata.xml",
+    "check:optional-chaining": "count=$(grep -rno '\\?\\.[a-zA-Z_$]' .next/static/chunks/* out/_next/static/chunks/* | wc -l); if [ \"$count\" -gt 0 ]; then echo '❌ Optional chaining found in output!'; exit 1; else echo '✅ No optional chaining found.'; fi",
+    "check:translations": "count=$(grep -rno '__STRING_NOT_TRANSLATED__' public/locales/* | wc -l); if [ \"$count\" -gt 0 ]; then echo '❌ Untranslated strings found!'; exit 1; else echo '✅ All strings translated.'; fi",
+    "check:lookbehind-regex": "count=$(grep -rnoE '\\(\\?<[!=]' .next/static/chunks/* out/_next/static/chunks/* | wc -l); if [ \"$count\" -gt 0 ]; then echo '❌ Lookbehind regex found in output!'; exit 1; else echo '✅ No lookbehind regex found.'; fi",
+    "check:all": "pnpm check:translations && pnpm check:lookbehind-regex",
+    "build-check": "pnpm build && pnpm build-web && pnpm check:all"
   },
   "dependencies": {
+    "@ai-sdk/react": "^3.0.49",
+    "@assistant-ui/react": "0.11.56",
+    "@assistant-ui/react-ai-sdk": "1.1.21",
+    "@assistant-ui/react-markdown": "0.11.9",
     "@aws-sdk/client-s3": "^3.735.0",
     "@aws-sdk/s3-request-presigner": "^3.735.0",
-    "@ducanh2912/next-pwa": "^10.2.9",
+    "@choochmeque/tauri-plugin-sharekit-api": "^0.3.0",
     "@fabianlars/tauri-plugin-oauth": "2",
+    "@opennextjs/cloudflare": "^1.15.1",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-hover-card": "^1.1.15",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-separator": "^1.1.8",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@serwist/next": "^9.4.2",
+    "@stripe/react-stripe-js": "^3.7.0",
+    "@stripe/stripe-js": "^7.4.0",
     "@supabase/auth-ui-react": "^0.4.7",
     "@supabase/auth-ui-shared": "^0.1.8",
-    "@supabase/supabase-js": "^2.47.7",
-    "@tauri-apps/api": "2.3.0",
-    "@tauri-apps/plugin-cli": "^2.2.0",
-    "@tauri-apps/plugin-deep-link": "^2.2.0",
-    "@tauri-apps/plugin-dialog": "^2.2.0",
-    "@tauri-apps/plugin-fs": "^2.2.0",
-    "@tauri-apps/plugin-haptics": "^2.2.3",
-    "@tauri-apps/plugin-http": "^2.3.0",
-    "@tauri-apps/plugin-log": "^2.2.3",
-    "@tauri-apps/plugin-opener": "^2.2.6",
-    "@tauri-apps/plugin-os": "^2.2.0",
-    "@tauri-apps/plugin-process": "^2.2.0",
-    "@tauri-apps/plugin-shell": "~2.2.0",
-    "@tauri-apps/plugin-updater": "^2.5.1",
-    "@zip.js/zip.js": "^2.7.53",
+    "@supabase/supabase-js": "^2.76.1",
+    "@tauri-apps/api": "2.9.1",
+    "@tauri-apps/plugin-cli": "^2.4.1",
+    "@tauri-apps/plugin-deep-link": "^2.4.6",
+    "@tauri-apps/plugin-dialog": "^2.6.0",
+    "@tauri-apps/plugin-fs": "^2.4.5",
+    "@tauri-apps/plugin-haptics": "^2.3.2",
+    "@tauri-apps/plugin-http": "^2.5.6",
+    "@tauri-apps/plugin-log": "^2.8.0",
+    "@tauri-apps/plugin-opener": "^2.5.3",
+    "@tauri-apps/plugin-os": "^2.3.2",
+    "@tauri-apps/plugin-process": "^2.3.1",
+    "@tauri-apps/plugin-shell": "~2.3.4",
+    "@tauri-apps/plugin-updater": "^2.9.0",
+    "@tauri-apps/plugin-websocket": "~2.4.2",
+    "@zip.js/zip.js": "^2.8.16",
+    "abortcontroller-polyfill": "^1.7.8",
+    "ai": "^6.0.47",
+    "ai-sdk-ollama": "^3.2.0",
+    "app-store-server-api": "^0.17.1",
+    "aws4fetch": "^1.0.20",
+    "buffer": "^6.0.3",
+    "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
     "cors": "^2.8.5",
-    "cssbeautify": "^0.3.1",
+    "dayjs": "^1.11.13",
+    "dompurify": "^3.3.0",
     "foliate-js": "workspace:*",
+    "franc-min": "^6.2.0",
+    "fzf": "^0.5.2",
+    "google-auth-library": "^10.5.0",
+    "googleapis": "^164.1.0",
+    "highlight.js": "^11.11.1",
     "i18next": "^24.2.0",
     "i18next-browser-languagedetector": "^8.0.2",
     "i18next-http-backend": "^3.0.1",
+    "iso-639-2": "^3.0.2",
+    "iso-639-3": "^3.0.1",
+    "isomorphic-ws": "^5.0.0",
     "js-md5": "^0.8.3",
     "jwt-decode": "^4.0.0",
-    "next": "15.2.2",
-    "posthog-js": "^1.205.0",
-    "react": "19.0.0",
+    "lucide-react": "^0.562.0",
+    "lunr": "^2.3.9",
+    "marked": "^15.0.12",
+    "nanoid": "^5.1.6",
+    "next": "16.1.6",
+    "nunjucks": "^3.2.4",
+    "overlayscrollbars": "^2.11.4",
+    "overlayscrollbars-react": "^0.5.6",
+    "posthog-js": "^1.246.0",
+    "react": "19.2.0",
     "react-color": "^2.19.3",
-    "react-dom": "19.0.0",
+    "react-dom": "19.2.0",
     "react-i18next": "^15.2.0",
     "react-icons": "^5.4.0",
     "react-responsive": "^10.0.0",
+    "react-virtuoso": "^4.17.0",
+    "react-window": "^1.8.11",
+    "remark-gfm": "^4.0.1",
+    "semver": "^7.7.1",
+    "streamdown": "^1.6.10",
+    "stripe": "^18.2.1",
+    "styled-jsx": "^5.1.7",
+    "tailwind-merge": "^3.4.0",
     "tinycolor2": "^1.6.0",
-    "zustand": "5.0.1"
+    "uuid": "^11.1.0",
+    "ws": "^8.18.3",
+    "zod": "^4.0.8",
+    "zustand": "5.0.10"
   },
   "devDependencies": {
-    "@tauri-apps/cli": "2.3.1",
+    "@next/bundle-analyzer": "^15.4.2",
+    "@tailwindcss/typography": "^0.5.16",
+    "@tauri-apps/cli": "2.9.6",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.3.0",
     "@types/cors": "^2.8.17",
     "@types/cssbeautify": "^0.3.5",
-    "@types/node": "^22.10.1",
-    "@types/react": "18.3.12",
+    "@types/lunr": "^2.3.7",
+    "@types/node": "^22.15.31",
+    "@types/nunjucks": "^3.2.6",
+    "@types/react": "^19.0.0",
     "@types/react-color": "^3.0.13",
-    "@types/react-dom": "18.3.1",
+    "@types/react-dom": "^19.0.0",
+    "@types/react-window": "^1.8.8",
+    "@types/semver": "^7.7.0",
     "@types/tinycolor2": "^1.4.6",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@typescript-eslint/parser": "^8.48.0",
+    "@vitejs/plugin-react": "^5.1.1",
     "autoprefixer": "^10.4.20",
+    "caniuse-lite": "^1.0.30001746",
     "cpx2": "^8.0.0",
     "daisyui": "^4.12.24",
     "dotenv-cli": "^7.4.4",
     "eslint": "^9.16.0",
-    "eslint-config-next": "15.0.3",
+    "eslint-config-next": "16.0.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
     "i18next-scanner": "^4.6.0",
+    "jsdom": "^26.1.0",
     "mkdirp": "^3.0.1",
     "node-env-run": "^4.0.2",
     "postcss": "^8.4.49",
     "postcss-cli": "^11.0.0",
     "postcss-nested": "^7.0.2",
     "raw-loader": "^4.0.2",
-    "tailwindcss": "^3.4.17",
-    "typescript": "^5.7.2"
+    "serwist": "^9.3.0",
+    "tailwindcss": "^3.4.18",
+    "typescript": "^5.7.2",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^4.0.15",
+    "wrangler": "^4.60.0"
   }
 }

apps/readest-app/public/.well-known/assetlinks.json

@@ -1,11 +1,15 @@
 [
   {
-    "relation": ["delegate_permission/common.handle_all_urls"],
+    "relation": [
+      "delegate_permission/common.handle_all_urls",
+      "delegate_permission/common.get_login_creds"
+    ],
     "target": {
       "namespace": "android_app",
       "package_name": "com.bilingify.readest",
       "sha256_cert_fingerprints": [
-        "65:2D:11:67:76:12:29:14:18:42:CB:3D:18:50:B6:E4:7E:46:E1:2F:4B:E4:7F:5A:6C:14:B6:D7:12:74:1E:82"
+        "65:2D:11:67:76:12:29:14:18:42:CB:3D:18:50:B6:E4:7E:46:E1:2F:4B:E4:7F:5A:6C:14:B6:D7:12:74:1E:82",
+        "E0:E7:60:55:80:8D:3A:DE:A0:D1:CF:7C:20:85:40:A3:DD:4B:E6:4D:17:5C:0F:DE:26:57:7D:9C:5B:29:5F:51"
       ]
     }
   }

apps/readest-app/public/.well-known/org.flathub.VerifiedApps.txt

@@ -0,0 +1 @@
+ed533042-5626-4704-b5f2-fa3bbd1136ed

apps/readest-app/public/locales/en/translation.json

@@ -1 +1,27 @@
-{}
+{
+  "LXGW WenKai GB Screen": "LXGW WenKai SC",
+  "LXGW WenKai TC": "LXGW WenKai TC",
+  "Source Han Serif CN": "Source Han Serif",
+  "Huiwen-MinchoGBK": "Huiwen Mincho",
+  "KingHwa_OldSong": "KingHwa Song",
+  "Are you sure to delete {{count}} selected book(s)?_one": "Are you sure to delete {{count}} selected book?",
+  "Are you sure to delete {{count}} selected book(s)?_other": "Are you sure to delete {{count}} selected books?",
+  "Search in {{count}} Book(s)..._one": "Search in {{count}} book...",
+  "Search in {{count}} Book(s)..._other": "Search in {{count}} books...",
+  "{{count}} pages left in chapter_one": "{{count}} page left in chapter",
+  "{{count}} pages left in chapter_other": "{{count}} pages left in chapter",
+  "Deleted {{count}} file(s)_one": "Deleted {{count}} file",
+  "Deleted {{count}} file(s)_other": "Deleted {{count}} files",
+  "Failed to delete {{count}} file(s)_one": "Failed to delete {{count}} file",
+  "Failed to delete {{count}} file(s)_other": "Failed to delete {{count}} files",
+  "{{count}} selected_one": "{{count}} selected",
+  "{{count}} selected_other": "{{count}} selected",
+  "Are you sure to delete {{count}} selected file(s)?_one": "Are you sure to delete {{count}} selected file?",
+  "Are you sure to delete {{count}} selected file(s)?_other": "Are you sure to delete {{count}} selected files?",
+  "Successfully imported {{count}} book(s)_one": "Successfully imported {{count}} book",
+  "Successfully imported {{count}} book(s)_other": "Successfully imported {{count}} books",
+  "Set status for {{count}} book(s)_one": "Set status for {{count}} book",
+  "Set status for {{count}} book(s)_other": "Set status for {{count}} books",
+  "{{count}} book(s) synced_one": "{{count}} book synced",
+  "{{count}} book(s) synced_other": "{{count}} books synced"
+}

apps/readest-app/release-notes.json

@@ -1,5 +1,721 @@
 {
   "releases": {
+    "0.9.99": {
+      "date": "2026-02-07",
+      "notes": [
+        "Reading: Added a reading ruler (line highlight) to help guide your eyes while reading",
+        "Reading: Added paragraph-by-paragraph reading mode for more focused navigation",
+        "Reading: Added a speed reading mode to support faster reading workflows",
+        "Reading: Added support for gamepad input to turn pages",
+        "Accessibility: Improved TalkBack support in dropdown menus for smoother navigation",
+        "Accessibility: Page navigation buttons are now always visible to screen readers",
+        "Accessibility: Reading progress is now updated correctly when navigating with screen readers",
+        "Annotations: Expanded highlight customization with more color options",
+        "Annotations: Added an option to export annotations as plain text",
+        "Library: Added grouping by author and series for better library organization",
+        "Library: Added support of marking books as finished",
+        "Search: Added fuzzy search to quickly find settings even with partial keywords",
+        "Table of Contents: Added page numbers for nested TOC entries",
+        "Text-to-Speech: Added navigation controls to return to the current reading position",
+        "Linux: Added an in-app updater for AppImage builds",
+        "E-ink: Improved color support for color E-ink devices to display richer highlights"
+      ]
+    },
+    "0.9.98": {
+      "date": "2026-01-21",
+      "notes": [
+        "Bookshelf: Added the ability to export original book files directly from the book details dialog",
+        "Bookshelf: Added a new sorting option to organize books by publish date",
+        "Bookshelf: Improved performance for large library with faster and more stable imports",
+        "OPDS: Improved download reliability by correctly detecting filenames for PDF and CBZ files",
+        "Proofreading: Added support for whole-word replacement to make text corrections more precise",
+        "Notes: Added the ability to export notes using a customizable template",
+        "PDF: Added support for panning within PDF documents for easier navigation",
+        "PDF: Improved performance by pre-rendering the next page for smoother page transitions",
+        "Text-to-Speech: Added support for word replacement to improve pronunciation during playback",
+        "Text-to-Speech: Fixed an issue where playback speed settings were not applied correctly on Linux",
+        "E-ink: Improved reading stability by preventing unwanted scrolling when animations are disabled or on e-ink devices",
+        "Discord: Added Discord Rich Presence to display your current reading status on Desktop platforms",
+        "Android: Fixed an issue that could cause occasional crashes during app startup",
+        "Fonts: Improved web font loading for faster and more stable text rendering"
+      ]
+    },
+    "0.9.97": {
+      "date": "2026-01-10",
+      "notes": [
+        "Annotations: Added annotation bubble icons directly on text with instant note popups",
+        "Annotations: Enabled quick highlighting when selecting text",
+        "Annotations: Added the ability to edit the text range of existing highlights",
+        "Annotations: Added an annotation navigation bar for easier browsing",
+        "OPDS: Fixed an issue where CBZ files could not be downloaded from OPDS catalogs",
+        "OPDS: Improved compatibility with Komga OPDS servers",
+        "OPDS: Added support for OPDS servers using self-signed SSL certificates",
+        "PDF: Fixed an issue where some PDF files failed to open",
+        "E-ink: Optimized colors and layout for improved e-ink device readability",
+        "Search: Added search term history for quicker repeated searches",
+        "Text-to-Speech: Reduced excessive pauses between sentences for smoother playback",
+        "File Transfer: Introduced a background transfer queue for uploading and downloading books",
+        "Proofreading: Added a proofread tool that can replace text directly within books"
+      ]
+    },
+    "0.9.96": {
+      "date": "2025-12-19",
+      "notes": [
+        "TTS: Resolved an issue where Edge TTS was blocked in certain regions",
+        "OPDS: Improved compatibility with older versions of Calibre Web",
+        "OPDS: Added an instant search bar for faster browsing in OPDS catalogs",
+        "OPDS: Added a curated book catalog from Standard Ebooks",
+        "Bookshelf: Added a “Group Books” action to the context menu",
+        "Comics: Fixed layout issues to improve comic book reading",
+        "Layout: Footnote popups now adapt correctly to different screen sizes",
+        "Layout: Fixed an issue where the maximum inline width was not applied to EPUBs",
+        "Sync: Improved file downloading by correctly handling special characters in filenames",
+        "UI: Added an option to temporarily dismiss the reading progress bar",
+        "Settings: Screen brightness adjustments now apply only to the reader view",
+        "iOS: You can now open files directly in Readest from the Files app",
+        "macOS: Added a global menu option to open files with Readest"
+      ]
+    },
+    "0.9.95": {
+      "date": "2025-12-08",
+      "notes": [
+        "OPDS: You can now search, browse, and download ebooks directly from OPDS catalogs",
+        "OPDS: Improved compatibility with Calibre Web for reliable downloads",
+        "OPDS: Fixed an issue where book covers from self-hosted Calibre OPDS servers did not display correctly",
+        "Cloud Storage: You can view and delete files stored in your cloud storage directly from the app",
+        "Bookshelf: Added support for importing books from a folder recursively",
+        "Bookshelf: You can now rename your bookshelf groups",
+        "EPUB: Added support for SVG covers from Standard Ebooks",
+        "Annotations: Keyboard shortcuts no longer copy selected text into the notebook",
+        "Footnotes: Footnote popups now scale properly on small screens",
+        "Touch/Styli: Removed the context menu for smoother interaction on touch and stylus devices",
+        "Layout: Devices with unfoldable screens now automatically switch to a two-column layout",
+        "PDF: Improved zoomed-in navigation and hand-tool behavior for smoother page navigation",
+        "Android: Fixed highlighting of the current sentence when using native Android text-to-speech",
+        "Android: Back button handling now works correctly on Android 15 and above",
+        "Android: You can now open files shared from other apps"
+      ]
+    },
+    "0.9.94": {
+      "date": "2025-12-02",
+      "notes": [
+        "OPDS: You can now browse and download ebooks directly from OPDS catalogs",
+        "PDF: Added a hand-tool mode that makes navigating PDF pages easier",
+        "Covers: You can now choose a folder to save the latest book cover image",
+        "CJK: Added one-tap conversion between Simplified and Traditional Chinese",
+        "Shortcuts: Use Ctrl + mouse wheel to quickly zoom in or out",
+        "Library: Added a new option to adjust cover sizes in grid view",
+        "Windows: Added Ebook thumbnails with book covers in Windows Explorer",
+        "TTS: Fixed an issue where the page would scroll when showing the annotator",
+        "Annotations: Resolved layout shifts when selecting text in paginated mode on Android",
+        "Files: Improved backup handling to prevent file corruption",
+        "Layout: Fixed text clipping caused by negative indents",
+        "E-ink: Improved sidebar and notebook background colors for e-ink devices",
+        "Android: The Back button now works properly in menus, dialogs, and alerts",
+        "iOS: Fixed occasional failures when opening books on older iOS versions (16.4 and below)"
+      ]
+    },
+    "0.9.93": {
+      "date": "2025-11-20",
+      "notes": [
+        "Sync: Improved reliability for new accounts so your books sync correctly from the start",
+        "Library: Fixed an occasional issue where returning to the library could get stuck",
+        "Layout: Improved image display in paginated mode so images won't exceed the available height",
+        "TXT: Improved performance and stability when opening and parsing TXT files",
+        "Fonts: Fixed an issue where monospace fonts were not applied correctly in code blocks"
+      ]
+    },
+    "0.9.92": {
+      "date": "2025-11-18",
+      "notes": [
+        "Bookshelf: Added support for nested groups to organize your books more flexibly",
+        "Sync: Improved reliability by automatically retrying failed book syncs",
+        "Sync: Improved token refresh so login sessions stay active longer on KOReader",
+        "E-Ink: Enhanced readability on the library page for E-Ink devices",
+        "UI: Storage capacity is now displayed with precise values in the user profile",
+        "Reader: You can now import files directly into the currently selected book group",
+        "Account: You can now update the email address linked to your Readest account",
+        "Footnotes: Added compatibility for more footnote formats"
+      ]
+    },
+    "0.9.91": {
+      "date": "2025-10-29",
+      "notes": [
+        "TTS: Fixed an issue where system voices were not working on Android",
+        "TTS: Added options to customize the highlight style during read-aloud",
+        "E-Ink: Disabled all shadows to improve display clarity",
+        "E-Ink: Added an option to save the last book cover on Android",
+        "Android: Fixed a crash that occurred when toggling 'Allow Script'",
+        "Android: Adjusted launcher icon size for better compatibility across devices"
+      ]
+    },
+    "0.9.90": {
+      "date": "2025-10-28",
+      "notes": [
+        "Sync: Faster library syncing and support for in-app one-time purchases of extra cloud storage",
+        "TTS: You can now choose the target language for read-aloud on translated books",
+        "Reader: New keyboard shortcuts make it easier to move between sections",
+        "Reader: Smoother scrolling for a more comfortable reading experience",
+        "Reader: Footnotes in definition lists are now fully supported",
+        "Reader: Improved search accuracy and display of search results",
+        "Reader: Clearer error messages when importing books",
+        "Reader: Improved safety when loading book content",
+        "Settings: You can now choose your own highlight colors",
+        "Settings: Added option to adjust screen brightness automatically",
+        "E-Ink: Better readability and clearer progress display with underlined links",
+        "Android: You can now store app data on an external SD card",
+        "iOS: Restores your last reading page if the app was closed in the background",
+        "Localization: Added Persian (Farsi) language support"
+      ]
+    },
+    "0.9.88": {
+      "date": "2025-10-18",
+      "notes": [
+        "TTS: Fixed issue where the read-aloud indicator disappeared too quickly",
+        "Layout: Overriding book layout no longer affects explicitly set text alignment",
+        "Reader: Added localized number display for reading progress in vertical layout",
+        "Reader: Enhanced swipe responsiveness for smoother page transitions",
+        "Settings: Added an option to disable animations when using E-Ink mode"
+      ]
+    },
+    "0.9.87": {
+      "date": "2025-10-16",
+      "notes": [
+        "Reader: Improved chapter detection with better chapter title recognition",
+        "Reader: Enhanced compatibility for parsing more footnote formats",
+        "Theme: Fixed auto theme switching in new reader windows",
+        "TTS: Improved scrolling accuracy to highlighted text during read-aloud",
+        "TTS: Fixed crash issues on certain Android systems"
+      ]
+    },
+    "0.9.86": {
+      "date": "2025-10-14",
+      "notes": [
+        "Reader: Added support for per-book background image customization",
+        "Reader: Added option to override book language metadata for improved hyphenation accuracy",
+        "Sync: Readest sync in KOReader can now be triggered using gesture controls",
+        "Sync: Fixed a crash in KOReader that occurred when syncing progress without an open book",
+        "Sync: Improved upload performance with concurrent upload support"
+      ]
+    },
+    "0.9.85": {
+      "date": "2025-10-14",
+      "notes": [
+        "TTS: Improved media session control compatibility across more Android systems",
+        "TTS: Made the TTS icon less distracting during read-aloud mode",
+        "Settings: Added an option to adjust screen brightness while reading",
+        "Settings: Added support for custom background images",
+        "PDF: Fixed an issue where scrolling and panning didn’t work correctly when zoomed in",
+        "Android: Added adaptive launcher icon for better system integration",
+        "Reader: Added keyboard shortcuts for toggling bookmarks",
+        "Reader: Annotations are now rendered instantly when opening files"
+      ]
+    },
+    "0.9.82": {
+      "date": "2025-10-01",
+      "notes": [
+        "Sync: More reliable syncing between KOReader and Readest",
+        "MOBI: Fixed an issue where some footnotes in MOBI/AZW files were not parsed correctly",
+        "Storage: Added support for changing data location on Windows, macOS, Linux, and Android",
+        "Windows: Portable EXE version now stores all reading data in the directory of the executable",
+        "Android: Added background TTS support with media session controls",
+        "WebView: Extended compatibility down to version 92",
+        "Settings: Added global settings menu to the library page",
+        "iOS: Fixed an issue where custom theme colors were not handled correctly on older Safari versions",
+        "TTS: Added more languages for Edge TTS"
+      ]
+    },
+    "0.9.81": {
+      "date": "2025-09-19",
+      "notes": [
+        "TTS: Added desktop common media control support when TTS is playing",
+        "PDF: Disabled swipe-up gesture for toggling the action bar when zoomed in",
+        "Fonts: Fixed an issue where embedded fonts in ebooks were occasionally not applied",
+        "Reader: Fixed an issue where newly created highlights sometimes would not appear",
+        "Reader: Enabled scrolling in the menu when the menu is too long"
+      ]
+    },
+    "0.9.80": {
+      "date": "2025-09-19",
+      "notes": [
+        "Accessibility: Added support for popular screen readers on all platforms, making books accessible to readers with visual impairments",
+        "Sync: Progress is now synced across different versions of the same book by aggregated metadata",
+        "Library: Groups are now displayed in list view for easier organization",
+        "Library: Added delete confirmation when removing books from the context menu",
+        "Fonts: Added support for fonts with subfamilies when importing TTF/OTF font files",
+        "Layout: Prevented layout shift in Android when the virtual keyboard appears"
+      ]
+    },
+    "0.9.78": {
+      "date": "2025-09-06",
+      "notes": [
+        "TTS: Added option to keep a persistent TTS bar at the bottom of the screen",
+        "TTS: Added previous/next sentence navigation controls in the TTS bar",
+        "TTS: Added media control support on iOS lock screen and AirPods",
+        "TTS: Fixed an issue where headings could not be highlighted for TTS",
+        "Sync: Fixed occasional sync failures between KOReader and Readest",
+        "Fonts: Grouped font styles into custom font families for easier selection",
+        "Reader: Improved text selection sensitivity when using a stylus",
+        "Reader: Books can now be properly closed using the system back button on Android",
+        "EPUB: Fixed parsing to correctly detect the front cover in some EPUB files",
+        "PDF: Added zoom level, zoom mode, and spread mode settings for PDFs",
+        "Reader: Bookmarks can now be edited directly in the sidebar",
+        "Layout: Prevented layout shift when the virtual keyboard appears on Android",
+        "TXT: Improved chapter detection and added support for nested table of contents in TXT files"
+      ]
+    },
+    "0.9.76": {
+      "date": "2025-08-30",
+      "notes": [
+        "Sync: Moved KOReader sync controls into the reader sidebar with a manual push/pull option",
+        "Sync: Improved tolerance and reliability for KOReader sync operations",
+        "Sync: Added support for more KOReader server implementations",
+        "Fonts: Added support for importing multiple styles within a font family",
+        "Reader: Fixed an issue where footnotes are empty in some EPUB files",
+        "Theme: Applied theme background color for PDFs on macOS",
+        "Reader: Added support for importing AZW3 files on Android",
+        "Reader: Reduced screen flash when launching the app and opening books",
+        "Layout: Fixed an issue where the grouping modal would not appear on Linux"
+      ]
+    },
+    "0.9.75": {
+      "date": "2025-08-22",
+      "notes": [
+        "Fonts: Added support for importing local TTF and ODF fonts",
+        "TTS: Reduced the pause between sentences when using Edge TTS",
+        "TTS: Fixed an issue where voices list could not be opened on older versions of iOS",
+        "TOC: Fixed an issue where nested TOC items would not collapse properly in some books",
+        "Translator: Fixed an issue where translations in the popup did not refresh correctly",
+        "Library: Added option to sort authors with last name first",
+        "Layout: Fixed mismatch in close button position between the reader and library pages",
+        "Layout: Book title now remains centered in the available space",
+        "Layout: Fixed footer bar layout in landscape mode"
+      ]
+    },
+    "0.9.72": {
+      "date": "2025-08-18",
+      "notes": [
+        "Fixed Edge TTS voice playback for EPUBs",
+        "Reduced accidental page flips when toggling toolbars",
+        "Fixed images with background colors not displaying correctly in some books",
+        "Added support for custom KOReader Sync Servers on your local network (LAN)"
+      ]
+    },
+    "0.9.71": {
+      "date": "2025-08-13",
+      "notes": [
+        "Sync: Added two ways to sync reading progress with KOReader devices",
+        "EPUB: Applied monospace font settings",
+        "EPUB: Fixed initial text alignment for some EPUB files",
+        "PDF: Fixed issue opening large PDF files on Android",
+        "TTS: Improved book language detection when language code is invalid",
+        "iOS: Fixed applying system color scheme in auto theme mode",
+        "Config: Added option to choose reading progress display style (percentage or page number)",
+        "Library: Added option to delete only the local copy of a book",
+        "Account: Added 'Reset Password' button in the account page"
+      ]
+    },
+    "0.9.69": {
+      "date": "2025-08-02",
+      "notes": [
+        "Updater: Fixed permission issue when updating in standalone reader window",
+        "Config: Added option to disable double‑click actions",
+        "EPUB: Fixed missing images in some EPUB files",
+        "EPUB: Corrected formatting for book subjects",
+        "TXT: Improved language detection when parsing TXT files",
+        "CSS: Resolved issue where custom font colors could not be applied",
+        "Layout: Corrected cover image width display in 'Fit' mode for list view",
+        "Layout: Fixed unintended scrolling in reader view when highlighting text"
+      ]
+    },
+    "0.9.68": {
+      "date": "2025-07-30",
+      "notes": [
+        "Reader: Files now open in a new window by default on Desktop",
+        "Translation: Skips translating content inside <pre>, <code>, and <math> tags",
+        "Performance: Improved multi-part downloading for large books",
+        "Sync: Resolved issue preventing some PDF files from syncing",
+        "CSS: Resolved issue with fixed font color in some EPUB files",
+        "TXT: Enhanced TXT parsing for better compatibility"
+      ]
+    },
+    "0.9.67": {
+      "date": "2025-07-22",
+      "notes": [
+        "Reader: Fixed file opening issue when filenames contain commas",
+        "Translation: Added Yandex Translator as a new translation provider",
+        "Layout: Hovering over header now reveals macOS traffic light window controls",
+        "Theme: Reader background color is now customizable for EPUB and PDF",
+        "Library: Search now includes book format, group names, and descriptions",
+        "Library: Various improvements to metadata editor and bookshelf management",
+        "Linux: Fixed social login failure on Linux systems"
+      ]
+    },
+    "0.9.66": {
+      "date": "2025-07-21",
+      "notes": [
+        "Layout: Fixed nested table of contents items not expanding in long TOC lists",
+        "Reader: Opening files from the OS now takes highest priority",
+        "TTS: Improved voice filtering for some language codes",
+        "App: Fixed loading issues on older browsers",
+        "App: Fixed wrong MIME types generated on Linux"
+      ]
+    },
+    "0.9.65": {
+      "date": "2025-07-19",
+      "notes": [
+        "Reader: Added support for opening multiple reader windows on desktop",
+        "Layout: Added visible window borders on Linux",
+        "TTS: Improved handling of invalid book language",
+        "TTS: Skipped reading footnote anchor links",
+        "Translation: Fixed an issue where table of contents entries were not translated",
+        "Sync: Edited book metadata is now included in sync across devices",
+        "iOS: Disabled context menu when long-pressing on book covers"
+      ]
+    },
+    "0.9.64": {
+      "date": "2025-07-16",
+      "notes": [
+        "Library: Added support to edit book metadata",
+        "Layout: Fixed bookmark icon placement when the sidebar is pinned",
+        "Reader: Fixed an issue where links to other chapters in EPUB files did not work",
+        "Reader: Lightened the highlight color in dark mode for better contrast",
+        "Reader: Pull-to-refresh gesture is now smoother and more responsive",
+        "Reader: Removed unintended indentation on images",
+        "Search: Improved responsiveness of full-text search for faster results"
+      ]
+    },
+    "0.9.63": {
+      "date": "2025-07-07",
+      "notes": [
+        "Reader: Fixed links not working in some MOBI books",
+        "TTS: Fixed an issue where some text was skipped during reading",
+        "Library: You can now delete only the cloud backup of a book without removing the local copy",
+        "Performance: Fonts in the font list now load only when displayed for faster startup",
+        "Performance: Opening large MOBI books is now significantly faster",
+        "Layout: Fixed overlay scrollbar display in longer TOC items list",
+        "Layout: Improved grid cover image height in crop mode",
+        "Layout: Removed unsupported screen orientation lock option on iPad",
+        "Layout: System context menu no longer appears when selecting text on iPad",
+        "Translation: Added Thai (th-TH) language support"
+      ]
+    },
+    "0.9.62": {
+      "date": "2025-07-02",
+      "notes": [
+        "Subscription: You can now upgrade to Readest Premium and manage your subscription",
+        "Reader: Added an option to toggle Parallel Reading when viewing multiple books",
+        "Translation: Added an option to show or hide the original text in translations",
+        "Layout: TOC on Android now uses an overlay scrollbar for easier navigation",
+        "Layout: Custom CSS can now also be applied to the library page",
+        "Fonts: Added three new CJK fonts to choose from",
+        "Shortcuts: Press ESC to quickly close the search bar"
+      ]
+    },
+    "0.9.61": {
+      "date": "2025-06-26",
+      "notes": [
+        "Layout: Fixed view menu width on smaller screens",
+        "Layout: Added option to crop or fit book covers in library view",
+        "Reader: You can now apply custom CSS to the reading interface (UI)",
+        "Reader: Added an option to show remaining pages in the current chapter",
+        "Settings: Added options to reset settings from the config dialog",
+        "Import: Fixed encoded filenames when importing TXT files on iOS",
+        "Linux: Fixed missing app icon on some Linux distributions",
+        "GitHub: Added donation link to support Readest development"
+      ]
+    },
+    "0.9.60": {
+      "date": "2025-06-22",
+      "notes": [
+        "Layout has been improved for iPad devices",
+        "Screen orientation changes are now smoother on iOS",
+        "Importing books on iOS during the first launch is now more reliable",
+        "Font size no longer changes unexpectedly in scrolled mode on iOS",
+        "Top and bottom safe insets are now ignored when no header or footer is present",
+        "Interactive books now load correctly on the Desktop platform",
+        "Translation is now disabled when the primary language is undefined",
+        "Android: the task list background color has been updated with current theme color"
+      ]
+    },
+    "0.9.59": {
+      "date": "2025-06-19",
+      "notes": [
+        "Layout: Image size now adjusts more accurately by converting screen units to pixels properly",
+        "Layout: Improved header layout on iOS landscape mode — extra spacing has been removed",
+        "Settings: Top and bottom margin settings are now more intuitive and better constrained"
+      ]
+    },
+    "0.9.58": {
+      "date": "2025-06-18",
+      "notes": [
+        "TTS: Translation now works even when TTS is playing in the background",
+        "TTS: Press T on your keyboard to quickly toggle TTS on or off",
+        "TTS: Each open book now has its own independent TTS controller",
+        "Annotations: Annotation tools now function properly while TTS is active",
+        "Settings: Margins for top, bottom, left, and right can now be adjusted individually",
+        "Settings: New option to always show the status bar while reading",
+        "Layout: Reader page now adapts better to device safe areas for a more comfortable layout",
+        "UI: Added creation timestamps to annotations and made various interface improvements",
+        "iPad: Multiple columns are now supported in portrait mode",
+        "iPad: Fixed issue where sidebars couldn't be resized by dragging",
+        "iPad: Added support for split-screen mode"
+      ]
+    },
+    "0.9.57": {
+      "date": "2025-06-14",
+      "notes": ["TTS: Fixed an issue to detect custom TTS engines on some Android devices"]
+    },
+    "0.9.56": {
+      "date": "2025-06-13",
+      "notes": [
+        "Performance: Improved TOC loading for books with very large chapter lists",
+        "TTS: Added support for native Android TTS engines (e.g., MultiTTS)",
+        "TTS: Fixed an issue where the next chapter would not load properly in the background",
+        "Translation: Improved accuracy and clarity of some Arabic translations",
+        "Reading: Added support for code syntax highlighting in books with code snippets"
+      ]
+    },
+    "0.9.55": {
+      "date": "2025-06-07",
+      "notes": [
+        "Sync: Notes deleted on other devices now correctly sync across all platforms",
+        "Layout: Now text justification can be unset in the layout settings",
+        "Translation: Added notification when daily translation quota is exceeded",
+        "Performance: Reduced unnecessary animations on Android to improve efficiency"
+      ]
+    },
+    "0.9.53": {
+      "date": "2025-06-05",
+      "notes": [
+        "Reader: New option to customize book foreground and background colors",
+        "Reader: Fixed an issue where images appeared too small in some EPUBs",
+        "EPUB: Improved cover image detection for certain EPUB files",
+        "TTS: Improved background playback stability on iOS devices",
+        "Translation: Introduced a daily DeepL translation quota to ensure long-term availability"
+      ]
+    },
+    "0.9.52": {
+      "date": "2025-06-03",
+      "notes": [
+        "Library: The search bar now shows the number of books currently displayed",
+        "Book Details: Book descriptions now support rich HTML formatting",
+        "Notebook: Added support for writing notes using Markdown",
+        "Notebook: You can now search within your notes",
+        "Sync: A sync status item has been added to the View menu",
+        "TOC: You can now sort the table of contents by page number",
+        "Reader: Option added to show remaining time in the current chapter"
+      ]
+    },
+    "0.9.51": {
+      "date": "2025-06-01",
+      "notes": [
+        "Translator: Table of contents is now included in translations",
+        "Library Theme: Added light, dark, and system theme options to the library page",
+        "TTS: Now shows the current sentence and chapter in the media session",
+        "TTS: Text-to-speech continues from the last read sentence",
+        "Pagination Fix: Taking notes no longer breaks page turning",
+        "EPUB Scripts: Added a setting to allow JavaScript in EPUB files"
+      ]
+    },
+    "0.9.50": {
+      "date": "2025-05-28",
+      "notes": [
+        "Bilingual TTS: You can now choose voices for each language in bilingual text-to-speech mode",
+        "Settings Layout: Improved header layout in the settings dialog for different screen sizes",
+        "CSS Fixes: Corrected anchor text color and fixed image dimensions within paragraphs"
+      ]
+    },
+    "0.9.49": {
+      "date": "2025-05-27",
+      "notes": [
+        "Select All in Library: You can now select all books at once when in selection mode",
+        "More Translation Options: Added support for Azure and Google Translate services",
+        "Dark Mode Enhancement: New option to invert image colors for better visibility in dark mode",
+        "Bilingual TTS: Enjoy bilingual text-to-speech for books with content in two languages",
+        "Full Book Translation: Translate books in any language into bilingual ebooks",
+        "Privacy Settings: Added a new option to opt-out of telemetry"
+      ]
+    },
+    "0.9.43": {
+      "date": "2025-05-19",
+      "notes": [
+        "Enhanced compatibility with Gutenberg and Feedbooks ebooks for better styling",
+        "Reduced sensitivity of trackpad and mouse during page flips",
+        "Cloud backup status is now visible for each book on mobile and desktop",
+        "New option to control scroll overlap when paginating in scroll mode",
+        "Added Dutch language translations",
+        "Added more font weight options for built-in fonts",
+        "Added previous and next section buttons in the footer bar for easier navigation"
+      ]
+    },
+    "0.9.41": {
+      "date": "2025-05-13",
+      "notes": [
+        "Improved UI and layout on mobile devices",
+        "Avatar images are now cached for offline use",
+        "Book file size is now displayed in the book details view",
+        "Update status is now correctly shown in the About window",
+        "TTS control positioning improved for notebook and RTL modes",
+        "TXT files are segmented by paragraph count if no chapter titles are found",
+        "Android: App now respects system auto-rotation settings",
+        "Linux: Updater is disabled on Linux when not using AppImage",
+        "Linux: Added support for Linux ARMHF builds",
+        "CSS: Resolved layout and color issues caused by hardcoded CSS"
+      ]
+    },
+    "0.9.40": {
+      "date": "2025-05-08",
+      "notes": [
+        "Prevented oversized images from causing layout issues",
+        "Resolved issue with transient navigation bar on Android 9",
+        "Action bar now closes properly when the footbar is dismissed",
+        "Smoother experience when expanding Table of Contents sections",
+        "Reverted unintended style overrides"
+      ]
+    },
+    "0.9.39": {
+      "date": "2025-05-07",
+      "notes": [
+        "Enhanced Navigation: Added location information to the table of contents",
+        "Enhanced Navigation: Larger touch targets for table of contents expansion icons",
+        "Screen Orientation Lock: You can now lock your device's screen orientation when reading",
+        "Quick Access to Recent Books: Option to automatically open your last read book when starting the app",
+        "Better Language Support: Improved handling of CJK characters in search",
+        "Enhanced Text-to-Speech: More accurate language detection for TTS",
+        "Enhanced Text-to-Speech: Text-to-Speech now maintains your position in scroll mode",
+        "Enhanced Annotations: Better handling of annotations with ruby elements in Japanese books",
+        "Smoother Scrolling: We've made continuous scrolling more reliable for a seamless reading experience",
+        "Compact View: Reading view is more compact when header and footer are hidden",
+        "TXT Parsing: More robust handling of TXT book format"
+      ]
+    },
+    "0.9.38": {
+      "date": "2025-04-29",
+      "notes": [
+        "Page Turning with Volume Keys: You can now turn pages using your device’s volume buttons",
+        "Expanded English Voices: More English voices are available across all en locales",
+        "Theme Editor: Added a primary color picker for easier customization",
+        "System Fonts: Retrieve system fonts on iOS and Android, with improved font weight and style detection",
+        "Popup Footnotes: Popup footnotes now inherit the book's font for consistent appearance",
+        "Better Text Selection: Preserves text selection anchors when spanning paginated content",
+        "Android Compatibility: Navigation bar auto-hides correctly on Android 10 and below",
+        "Popup Dialogs: Back key now properly dismisses popup dialogs on Android"
+      ]
+    },
+    "0.9.37": {
+      "date": "2025-04-25",
+      "notes": [
+        "Full-Screen Toggle: You can now press F11 to quickly toggle full-screen mode",
+        "List View: A new list layout is available for your bookshelf",
+        "Book Details: Book descriptions from metadata are now shown in the details view",
+        "Enhanced Android behavior: better navigation bar handling and status bar dismissal when resuming",
+        "TTS now defaults to the book’s metadata language when needed",
+        "Synced custom themes reliably across sessions"
+      ]
+    },
+    "0.9.36": {
+      "date": "2025-04-20",
+      "notes": [
+        "📥 New download and upload buttons in the book detail dialog for easier file management",
+        "📂 You can now open files directly in Readest from your file manager on Android and iOS",
+        "🛠️ Fixed an issue where files with quotation marks in the filename could not be opened",
+        "📖 Improved the immersive reading experience on the reader page for Android and iOS",
+        "🌐 Added GuanKiapTsingKhai-T to the list of available CJK fonts"
+      ]
+    },
+    "0.9.35": {
+      "date": "2025-04-15",
+      "notes": [
+        "🛠️ Fixed an issue where books without cover images can not be synced across devices",
+        "📱 Added in-app update support for Android",
+        "📚 You can now sort books by title or author in your library"
+      ]
+    },
+    "0.9.33": {
+      "date": "2025-04-13",
+      "notes": [
+        "New: Redesigned update dialog with a progress bar during downloads for a smoother update experience.",
+        "New: You can now set header and footer visibility separately for paginated and scroll modes.",
+        "Fixed layout issues in the bottom configuration panel when using RTL (right-to-left) languages.",
+        "Fixed TXT file import issues on Android by improving support for content provider file paths.",
+        "Fixed transformed punctuations when highlighting text with vertical layout.",
+        "Improved login flow on macOS by handling OAuth with the native ASWebAuthenticationSession."
+      ]
+    },
+    "0.9.32": {
+      "date": "2025-04-09",
+      "notes": [
+        "No more resetting of font size and color when you apply custom book styles",
+        "The underline and squiggly highlight decorations have been adjusted to sit neatly between text lines",
+        "With more font options available, the font menu is no longer forced in-line",
+        "LXGW WenKai TC is now part of our CJK font list"
+      ]
+    },
+    "0.9.31": {
+      "date": "2025-04-08",
+      "notes": [
+        "iOS: Text-to-Speech (TTS) now works in the background",
+        "Android: Import files from native file manager",
+        "Desktop: Add option to keep window on top",
+        "Vertical layout for highlighting tools",
+        "Added options to auto-stop TTS after timeout",
+        "Added book search functionality in bookshelf",
+        "Improved font support for CJK users"
+      ]
+    },
+    "0.9.30": {
+      "date": "2025-04-05",
+      "notes": [
+        "Added fixed storage quota when running the app in self-hosted mode",
+        "Link colors will only change when you override fonts",
+        "Added cache for native files for better performance"
+      ]
+    },
+    "0.9.29": {
+      "date": "2025-04-02",
+      "notes": [
+        "Improved Login on Android without needing to rely on external Chrome browser",
+        "Local large book files now load more efficiently on Android",
+        "Balanced the load of online service between different types of users to keep things running smoothly for everyone"
+      ]
+    },
+    "0.9.28": {
+      "date": "2025-03-30",
+      "notes": [
+        "Improved vertical reading mode with better support for Chinese punctuations",
+        "Fixed TXT file importing issue on desktop apps — TXT books now load reliably and display as expected",
+        "Improved annotation experience — highlighting tools are now properly dismissed when adding notes to avoid UI conflicts"
+      ]
+    },
+    "0.9.27": {
+      "date": "2025-03-29",
+      "notes": [
+        "Added option to swap click-to-flip area and reset password",
+        "Added global shortcuts for full-text search",
+        "Added support for both R2 and S3 storage in cloud sync",
+        "Improved TTS with fewer unintended pauses, faster startup, and support for preferred voices",
+        "Various fixes for rendering styles and UI layout"
+      ]
+    },
+    "0.9.26": {
+      "date": "2025-03-27",
+      "notes": [
+        "Support open book from file manager without importing",
+        "Add LXGW WenKai font in Serif fonts list",
+        "Various fixes on layout and styles on Windows and Android"
+      ]
+    },
+    "0.9.25": {
+      "date": "2025-03-24",
+      "notes": [
+        "Support exporting annotations in markdown format",
+        "Support importing TXT files",
+        "Support setting reader language in the UI",
+        "Add bottom action bar on mobile platforms",
+        "Various fixes on layout settings and styles"
+      ]
+    },
     "0.9.23": {
       "date": "2025-03-19",
       "notes": [

apps/readest-app/scripts/release-google-play.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+
+set -e
+
+VERSION=$(jq -r '.version' package.json)
+MANIFEST="./src-tauri/gen/android/app/src/main/AndroidManifest.xml"
+INSTALL_PERMISSION_LINE='<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>'
+STORAGE_PERMISSION_LINE='<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>'
+
+ised() {
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    sed -i '' "$@"
+  else
+    sed -i "$@"
+  fi
+
+  return $?
+}
+
+# --- REMOVE PERMISSION BEFORE BUILD ---
+if grep -q 'REQUEST_INSTALL_PACKAGES' "$MANIFEST"; then
+  echo "🧹 Removing REQUEST_INSTALL_PACKAGES from AndroidManifest.xml"
+  if ised "/REQUEST_INSTALL_PACKAGES/d" "$MANIFEST"; then
+    echo "✅ Successfully removed REQUEST_INSTALL_PACKAGES"
+  else
+    echo "❌ Failed to remove REQUEST_INSTALL_PACKAGES" >&2
+    exit 1
+  fi
+fi
+
+if grep -q 'MANAGE_EXTERNAL_STORAGE' "$MANIFEST"; then
+  echo "🧹 Removing MANAGE_EXTERNAL_STORAGE from AndroidManifest.xml"
+  if ised "/MANAGE_EXTERNAL_STORAGE/d" "$MANIFEST"; then
+    echo "✅ Successfully removed MANAGE_EXTERNAL_STORAGE"
+  else
+    echo "❌ Failed to remove MANAGE_EXTERNAL_STORAGE" >&2
+    exit 1
+  fi
+fi
+
+echo "🚀 Running: pnpm tauri android build"
+pnpm tauri android build --config src-tauri/tauri.playstore.conf.json
+
+# --- ADD PERMISSION BACK AFTER BUILD ---
+if ! grep -q 'REQUEST_INSTALL_PACKAGES' "$MANIFEST"; then
+  echo "♻️  Restoring REQUEST_INSTALL_PACKAGES in AndroidManifest.xml"
+  ised "/android.permission.INTERNET/a\\
+    $INSTALL_PERMISSION_LINE
+  " "$MANIFEST"
+fi
+
+if ! grep -q 'MANAGE_EXTERNAL_STORAGE' "$MANIFEST"; then
+  echo "♻️  Restoring MANAGE_EXTERNAL_STORAGE in AndroidManifest.xml"
+  ised "/android.permission.WRITE_EXTERNAL_STORAGE/a\\
+    $STORAGE_PERMISSION_LINE
+  " "$MANIFEST"
+fi
+
+source .env.google-play.local
+if [[ -z "$GOOGLE_PLAY_JSON_KEY_FILE" ]]; then
+  echo "❌ GOOGLE_PLAY_JSON_KEY_FILE is not set"
+  exit 1
+fi
+cd ../../
+
+fastlane android upload_production

apps/readest-app/scripts/release-mac-appstore.sh

@@ -1,3 +1,22 @@
+#!/bin/bash
+set -e
+
+echo "Updating bundleVersion in tauri.appstore.conf.json..."
+
+CONFIG_FILE="src-tauri/tauri.appstore.conf.json"
+CURRENT_DATE=$(date "+%Y%m%d.%H%M%S")
+
+if [ ! -f "$CONFIG_FILE" ]; then
+  echo "Error: Config file $CONFIG_FILE not found!"
+  exit 1
+fi
+
+TMP_FILE=$(mktemp)
+cat "$CONFIG_FILE" | jq --arg version "$CURRENT_DATE" '.bundle.macOS.bundleVersion = $version' > "$TMP_FILE"
+mv "$TMP_FILE" "$CONFIG_FILE"
+echo "Updated bundleVersion to $CURRENT_DATE"
+
+echo "Building macOS universal app for App Store..."
 pnpm run build-macos-universial-appstore
 
 BUNDLE_DIR=../../target/universal-apple-darwin/release/bundle/macos

apps/readest-app/scripts/sync-release-notes.sh

@@ -0,0 +1,183 @@
+#!/bin/bash
+
+# Sync release notes from JSON to XML AppData file
+# Usage: ./sync_release_notes.sh [json_file] [xml_file]
+#
+# Description:
+#   Extracts release information from a JSON file and updates the <releases>
+#   section in an AppData XML file, then calculates the SHA256 checksum.
+#
+# Arguments:
+#   json_file: Path to JSON file (default: releases.json)
+#   xml_file:  Path to XML file (default: appdata.xml)
+
+set -e
+set -o pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Helper functions
+log_info() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}✗${NC} $1" >&2
+}
+
+# Check if required commands are available
+if ! command -v jq >/dev/null 2>&1; then
+    log_error "jq is required but not installed."
+    echo "Install it with: apt-get install jq (Debian/Ubuntu) or brew install jq (macOS)"
+    exit 1
+fi
+
+# Parse arguments
+JSON_FILE="${1:-releases.json}"
+XML_FILE="${2:-appdata.xml}"
+
+# Validate input files
+if [ ! -f "$JSON_FILE" ]; then
+    log_error "JSON file '$JSON_FILE' not found"
+    exit 1
+fi
+
+if [ ! -f "$XML_FILE" ]; then
+    log_error "XML file '$XML_FILE' not found"
+    exit 1
+fi
+
+# Validate JSON format
+if ! jq empty "$JSON_FILE" 2>/dev/null; then
+    log_error "Invalid JSON format in '$JSON_FILE'"
+    exit 1
+fi
+
+# Check if releases key exists
+if ! jq -e '.releases' "$JSON_FILE" >/dev/null 2>&1; then
+    log_error "No 'releases' key found in JSON file"
+    exit 1
+fi
+
+echo "================================================"
+echo "Release Notes Sync Tool"
+echo "================================================"
+echo "Source: $JSON_FILE"
+echo "Target: $XML_FILE"
+echo ""
+
+# Create backup
+BACKUP_FILE="${XML_FILE}.backup.$(date +%Y%m%d_%H%M%S)"
+cp "$XML_FILE" "$BACKUP_FILE"
+log_info "Created backup: $BACKUP_FILE"
+
+# Create temporary files
+TEMP_XML=$(mktemp)
+TEMP_RELEASES=$(mktemp)
+
+# Cleanup function
+cleanup() {
+    rm -f "$TEMP_XML" "$TEMP_RELEASES"
+}
+trap cleanup EXIT
+
+# Extract releases from JSON and convert to XML format
+log_info "Extracting releases from JSON..."
+RELEASE_COUNT=$(jq '.releases | length' "$JSON_FILE")
+echo "  Found $RELEASE_COUNT releases"
+
+jq -r '
+.releases | to_entries | .[0:10] |  .[] |
+"    <release version=\"\(.key)\" date=\"\(.value.date)\">
+      <description>
+        <ul>
+" +
+((.value.notes | map("          <li>\(.)</li>")) | join("\n")) +
+"
+        </ul>
+      </description>
+    </release>"
+' "$JSON_FILE" > "$TEMP_RELEASES"
+
+# Find the releases section in XML and replace it
+log_info "Updating XML file..."
+awk -v releases="$TEMP_RELEASES" '
+BEGIN { in_releases = 0; printed_releases = 0 }
+/<releases>/ {
+    print $0
+    if (printed_releases == 0) {
+        while ((getline line < releases) > 0) {
+            print line
+        }
+        close(releases)
+        printed_releases = 1
+    }
+    in_releases = 1
+    next
+}
+/<\/releases>/ {
+    in_releases = 0
+    print $0
+    next
+}
+in_releases { next }
+{ print }
+' "$XML_FILE" > "$TEMP_XML"
+
+# Validate the generated XML
+if ! grep -q "<releases>" "$TEMP_XML" || ! grep -q "</releases>" "$TEMP_XML"; then
+    log_error "Failed to generate valid XML structure"
+    log_warn "Restoring from backup..."
+    mv "$BACKUP_FILE" "$XML_FILE"
+    exit 1
+fi
+
+# Remove backup if everything is fine
+rm "$BACKUP_FILE"
+
+# Replace original file
+mv "$TEMP_XML" "$XML_FILE"
+log_info "XML file updated successfully"
+
+# Calculate SHA256 checksum
+echo ""
+log_info "Calculating SHA256 checksum..."
+if command -v sha256sum >/dev/null 2>&1; then
+    CHECKSUM=$(sha256sum "$XML_FILE" | awk '{print $1}')
+elif command -v shasum >/dev/null 2>&1; then
+    CHECKSUM=$(shasum -a 256 "$XML_FILE" | awk '{print $1}')
+else
+    log_error "Neither sha256sum nor shasum found"
+    exit 1
+fi
+
+# Save checksum to file
+CHECKSUM_FILE="${XML_FILE}.sha256"
+echo "$CHECKSUM  $XML_FILE" > "$CHECKSUM_FILE"
+
+echo ""
+echo "================================================"
+echo "Summary"
+echo "================================================"
+echo "  Updated file:  $XML_FILE"
+echo "  Backup file:   $BACKUP_FILE"
+echo "  Checksum file: $CHECKSUM_FILE"
+echo "  SHA256:        $CHECKSUM"
+echo "  Releases:      $RELEASE_COUNT"
+echo ""
+log_info "Sync completed successfully!"
+echo ""
+echo "To verify the checksum, run:"
+if command -v sha256sum >/dev/null 2>&1; then
+    echo "  sha256sum -c $CHECKSUM_FILE"
+else
+    echo "  shasum -a 256 -c $CHECKSUM_FILE"
+fi

apps/readest-app/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "Readest"
-version = "0.2.1"
+version = "0.2.2"
 description = "Your online library"
 authors = ["Bilingify LLC"]
 license = ""
@@ -14,50 +14,62 @@ rust-version = "1.77.2"
 name = "readestlib"
 crate-type = ["staticlib", "cdylib", "lib"]
 
+[features]
+# Internal feature to suppress warnings from old objc crate
+cargo-clippy = []
+
 [build-dependencies]
-tauri-build = { version = "2.0.3", features = [] }
+tauri-build = { version = "2", features = [] }
 
 [dependencies]
 serde_json = "1.0"
 serde = { version = "1.0", features = ["derive"] }
 log = "0.4"
 thiserror = "2"
+walkdir = "2"
 tokio = { version = "1", features = ["fs"] }
 tokio-util = { version = "0.7", features = ["codec"] }
 futures-util = "0.3"
+futures = "0.3.31"
 read-progress-stream = "1.0.0"
 reqwest = { version = "0.12", default-features = false, features = [
   "json",
   "stream",
 ] }
-# FIXME: remove the devtools feature in production
-tauri = { version = "2.1.1", features = [ "protocol-asset", "devtools"] }
-tauri-build = "2.0.3"
-tauri-plugin-log = "2.0.2"
-tauri-plugin-fs = "2.0.3"
-tauri-plugin-dialog = "2.0.3"
-tauri-plugin-os = "2.0.1"
-tauri-plugin-http = "2.0.3"
-tauri-plugin-devtools = "2.0.0"
+tauri = { version = "2", features = [ "protocol-asset" ] }
+tauri-build = "2"
+tauri-plugin-log = "2"
+tauri-plugin-fs = "2"
+tauri-plugin-dialog = "2"
+tauri-plugin-os = "2"
+tauri-plugin-http = { version = "2", features = ["dangerous-settings"] }
 tauri-plugin-shell = "2"
 tauri-plugin-process = "2"
 tauri-plugin-oauth = "2"
-tauri-plugin-opener = "2.2.2"
+tauri-plugin-opener = "2"
 tauri-plugin-deep-link = "2"
 tauri-plugin-sign-in-with-apple = "1.0.2"
-tauri-plugin-haptics = "2.2.3"
-tauri-plugin-safari-auth = { path = "./plugins/tauri-plugin-safari-auth" }
-[patch.crates-io]
-tauri = { path = "../../../packages/tauri/crates/tauri" }
+tauri-plugin-haptics = "2"
+tauri-plugin-persisted-scope = "2"
+tauri-plugin-native-bridge = { path = "./plugins/tauri-plugin-native-bridge" }
+tauri-plugin-native-tts = { path = "./plugins/tauri-plugin-native-tts" }
+tauri-plugin-websocket = "2"
+tauri-plugin-sharekit = "0.3"
 
 [target."cfg(target_os = \"macos\")".dependencies]
+rand = "0.8"
 cocoa = "0.25"
 objc = "0.2.7"
-rand = "0.8"
+objc-foundation = "0.1.1"
+objc_id = "0.1.1"
+block = "0.1.6"
+objc2 = "0.6"
+objc2-authentication-services = "0.3"
+objc2-foundation = { version = "0.3", features = ["NSError", "NSArray"] }
 
 [target.'cfg(any(target_os = "macos", windows, target_os = "linux"))'.dependencies]
 tauri-plugin-cli = "2"
-tauri-plugin-single-instance = "2.2.0"
+tauri-plugin-single-instance = "2"
 tauri-plugin-updater = "2"
-tauri-plugin-window-state = "2.2.0"
-font-enumeration = "0.9.0"
+tauri-plugin-window-state = "2"
+discord-rich-presence = "1.0.0"

apps/readest-app/src-tauri/Info-ios.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>LSSupportsOpeningDocumentsInPlace</key>
+    <true/>
+  </dict>
+</plist>

apps/readest-app/src-tauri/Info.plist

@@ -0,0 +1,362 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>ITSAppUsesNonExemptEncryption</key>
+    <false/>
+    <key>LSSupportsOpeningDocumentsInPlace</key>
+    <false/>
+    <key>UIViewControllerBasedStatusBarAppearance</key>
+    <false/>
+    <key>UIHomeIndicatorAutoHidden</key>
+    <true/>
+    <key>UIRequiresFullScreen</key>
+    <false/>
+    <key>CFBundleDocumentTypes</key>
+    <array>
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>EPUB Document</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>org.idpf.epub-container</string>
+        </array>
+      </dict>
+
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>PDF Document</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>com.adobe.pdf</string>
+        </array>
+      </dict>
+
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>FB2 Document</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>com.readest.fb2</string>
+        </array>
+      </dict>
+
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>CBZ Archive</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>com.readest.cbz</string>
+        </array>
+      </dict>
+
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>MOBI Document</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>org.mobipocket.mobi</string>
+        </array>
+      </dict>
+
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>AZW Document</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>com.amazon.azw</string>
+          <string>com.amazon.azw3</string>
+        </array>
+      </dict>
+
+      <dict>
+        <key>CFBundleTypeName</key>
+        <string>Text File</string>
+        <key>LSHandlerRank</key>
+        <string>Alternate</string>
+        <key>CFBundleTypeRole</key>
+        <string>Viewer</string>
+        <key>LSItemContentTypes</key>
+        <array>
+          <string>public.plain-text</string>
+        </array>
+      </dict>
+    </array>
+
+    <key>UTImportedTypeDeclarations</key>
+    <array>
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>org.idpf.epub-container</string>
+        <key>UTTypeDescription</key>
+        <string>EPUB Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+          <string>public.composite-content</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>epub</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/epub+zip</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.adobe.pdf</string>
+        <key>UTTypeDescription</key>
+        <string>PDF Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+          <string>public.composite-content</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>pdf</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/pdf</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.readest.fb2</string>
+        <key>UTTypeDescription</key>
+        <string>FB2 Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.xml</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>fb2</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/xml</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.readest.cbz</string>
+        <key>UTTypeDescription</key>
+        <string>CBZ Archive</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.archive</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>cbz</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/x-cbz</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>org.mobipocket.mobi</string>
+        <key>UTTypeDescription</key>
+        <string>MOBI Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>mobi</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/x-mobipocket-ebook</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.amazon.azw</string>
+        <key>UTTypeDescription</key>
+        <string>AZW Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>azw</string>
+            <string>azw3</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/vnd.amazon.ebook</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>public.plain-text</string>
+        <key>UTTypeDescription</key>
+        <string>Text File</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+          <string>public.content</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>txt</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>text/plain</string>
+        </dict>
+      </dict>
+    </array>
+
+    <key>UTExportedTypeDeclarations</key>
+    <array>
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>org.idpf.epub-container</string>
+        <key>UTTypeDescription</key>
+        <string>EPUB Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+          <string>public.content</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>epub</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/epub+zip</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.readest.fb2</string>
+        <key>UTTypeDescription</key>
+        <string>FB2 Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.xml</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>fb2</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/xml</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.readest.cbz</string>
+        <key>UTTypeDescription</key>
+        <string>CBZ Archive</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.archive</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>cbz</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/x-cbz</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>org.mobipocket.mobi</string>
+        <key>UTTypeDescription</key>
+        <string>MOBI Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>mobi</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/x-mobipocket-ebook</string>
+        </dict>
+      </dict>
+
+      <dict>
+        <key>UTTypeIdentifier</key>
+        <string>com.amazon.azw</string>
+        <key>UTTypeDescription</key>
+        <string>AZW Document</string>
+        <key>UTTypeConformsTo</key>
+        <array>
+          <string>public.data</string>
+        </array>
+        <key>UTTypeTagSpecification</key>
+        <dict>
+          <key>public.filename-extension</key>
+          <array>
+            <string>azw</string>
+            <string>azw3</string>
+          </array>
+          <key>public.mime-type</key>
+          <string>application/vnd.amazon.ebook</string>
+        </dict>
+      </dict>
+    </array>
+  </dict>
+</plist>

apps/readest-app/src-tauri/build.rs

@@ -1,3 +1,65 @@
+use std::{env, fs, path::PathBuf, process::Command};
+
 fn main() {
+    println!("cargo:rerun-if-changed=../extensions/windows-thumbnail/src");
+    let target_os = env::var("CARGO_CFG_TARGET_OS").unwrap_or_default();
+    if target_os == "windows" {
+        build_windows_thumbnail();
+    }
+
     tauri_build::build()
 }
+
+fn build_windows_thumbnail() {
+    let manifest_dir = PathBuf::from(env::var("CARGO_MANIFEST_DIR").unwrap());
+    let dll_crate_dir = manifest_dir
+        .join("..")
+        .join("extensions")
+        .join("windows-thumbnail");
+    let dll_crate_manifest = dll_crate_dir.join("Cargo.toml");
+    let profile = env::var("PROFILE").unwrap_or_else(|_| "debug".into());
+
+    let mut cmd = Command::new(env::var("CARGO").unwrap_or("cargo".into()));
+    cmd.arg("build")
+        .arg("--package")
+        .arg("windows_thumbnail")
+        .arg("--manifest-path")
+        .arg(&dll_crate_manifest);
+
+    if profile == "release" {
+        cmd.arg("--release");
+    }
+
+    let target_triple = env::var("TARGET").unwrap_or_default();
+    let host_triple = env::var("HOST").unwrap_or_default();
+    if !target_triple.is_empty() && target_triple != host_triple {
+        cmd.arg("--target").arg(&target_triple);
+    }
+
+    let status = cmd
+        .status()
+        .expect("Failed to run cargo build for windows_thumbnail");
+    if !status.success() {
+        panic!("Failed to build windows_thumbnail DLL");
+    }
+
+    let dll_name = "windows_thumbnail.dll";
+    let candidate_paths = [
+        dll_crate_dir.join("target").join(&profile).join(dll_name),
+        dll_crate_dir
+            .join("target")
+            .join(&target_triple)
+            .join(&profile)
+            .join(dll_name),
+    ];
+
+    let dll_src = candidate_paths
+        .iter()
+        .find(|p| p.exists())
+        .expect("Failed to find built windows_thumbnail DLL");
+
+    let dll_dest = &dll_crate_dir.join("target").join(dll_name);
+
+    fs::copy(dll_src, dll_dest).expect("Failed to copy windows_thumbnail DLL");
+    println!("cargo:rerun-if-changed={}", dll_dest.display());
+}

apps/readest-app/src-tauri/capabilities/default.json

@@ -2,7 +2,7 @@
   "$schema": "../gen/schemas/desktop-schema.json",
   "identifier": "default",
   "description": "enables the default permissions",
-  "windows": ["main"],
+  "windows": ["main", "updater", "reader-*"],
   "permissions": [
     "core:default",
     "fs:default",
@@ -39,17 +39,84 @@
         }
       ]
     },
+    {
+      "identifier": "fs:allow-cache-read",
+      "allow": [
+        {
+          "path": "$APPCACHE/**/*"
+        },
+        {
+          "path": "/private/var/mobile/Containers/Data/Application/**/*"
+        }
+      ]
+    },
+    {
+      "identifier": "fs:allow-cache-write",
+      "allow": [
+        {
+          "path": "$APPCACHE/**/*"
+        },
+        {
+          "path": "/private/var/mobile/Containers/Data/Application/**/*"
+        }
+      ]
+    },
+    {
+      "identifier": "fs:scope",
+      "allow": [
+        {
+          "path": "**/Readest"
+        },
+        {
+          "path": "**/Readest/**/*"
+        },
+        {
+          "path": "**/last-book-cover.png"
+        }
+      ]
+    },
     {
       "identifier": "http:default",
       "allow": [
+        {
+          "url": "https://*.readest.com"
+        },
+        {
+          "url": "https://github.com/readest/*"
+        },
         {
           "url": "https://*.deepl.com"
         },
         {
           "url": "https://*.cloudflarestorage.com"
+        },
+        {
+          "url": "https://edge.microsoft.com"
+        },
+        {
+          "url": "https://translate.toil.cc"
+        },
+        {
+          "url": "https://*.microsofttranslator.com"
+        },
+        {
+          "url": "https://translate.googleapis.com"
+        },
+        {
+          "url": "http://*:*"
+        },
+        {
+          "url": "https://*:*"
+        },
+        {
+          "url": "http://*"
+        },
+        {
+          "url": "https://*"
         }
       ]
     },
+    "websocket:default",
     "dialog:default",
     "os:default",
     "core:window:default",
@@ -57,12 +124,18 @@
     "core:window:allow-center",
     "core:window:allow-minimize",
     "core:window:allow-maximize",
+    "core:window:allow-unmaximize",
     "core:window:allow-set-size",
     "core:window:allow-set-focus",
     "core:window:allow-is-maximized",
     "core:window:allow-start-dragging",
     "core:window:allow-toggle-maximize",
     "core:window:allow-set-fullscreen",
+    "core:window:allow-set-always-on-top",
+    "core:window:allow-destroy",
+    "core:webview:allow-create-webview-window",
+    "core:path:allow-resolve-directory",
+    "log:default",
     "shell:default",
     "process:default",
     "process:allow-exit",
@@ -71,11 +144,41 @@
     "oauth:allow-cancel",
     "sign-in-with-apple:default",
     "opener:default",
+    {
+      "identifier": "opener:allow-open-url",
+      "allow": [
+        {
+          "url": "alipays:*"
+        }
+      ]
+    },
+    {
+      "identifier": "shell:allow-spawn",
+      "allow": [
+        {
+          "name": "start-readest",
+          "cmd": "cmd",
+          "args": ["/C", "start", "", { "validator": "^.*Readest(.*)\\.exe$" }]
+        },
+        {
+          "name": "chmod-appimage",
+          "cmd": "chmod",
+          "args": ["+x", { "validator": "^.*Readest(.*)\\.AppImage$" }]
+        },
+        {
+          "name": "launch-appimage",
+          "cmd": "setsid",
+          "args": [{ "validator": "^.*Readest(.*)\\.AppImage$" }]
+        }
+      ]
+    },
     "haptics:allow-vibrate",
     "haptics:allow-impact-feedback",
     "haptics:allow-notification-feedback",
     "haptics:allow-selection-feedback",
-    "safari-auth:default",
-    "deep-link:default"
+    "deep-link:default",
+    "sharekit:default",
+    "native-tts:default",
+    "native-bridge:default"
   ]
 }

apps/readest-app/src-tauri/capabilities/desktop.json

@@ -1,10 +1,7 @@
 {
   "$schema": "../gen/schemas/desktop-schema.json",
   "identifier": "desktop-capability",
-  "windows": ["main"],
+  "windows": ["main", "updater", "reader-*"],
   "platforms": ["linux", "macOS", "windows"],
-  "permissions": [
-    "updater:default",
-    "cli:default"
-   ]
+  "permissions": ["updater:default", "cli:default"]
 }

apps/readest-app/src-tauri/gen/android/app/build.gradle.kts

@@ -15,28 +15,29 @@ val tauriProperties = Properties().apply {
 }
 
 android {
-    compileSdk = 34
+    compileSdk = 36
     namespace = "com.bilingify.readest"
+    val keystorePropertiesFile = rootProject.file("keystore.properties")
+    val keystoreProperties = Properties()
+    if (keystorePropertiesFile.exists()) {
+        keystoreProperties.load(FileInputStream(keystorePropertiesFile))
+    }
     defaultConfig {
         manifestPlaceholders["usesCleartextTraffic"] = "false"
         applicationId = "com.bilingify.readest"
         minSdk = 26
-        targetSdk = 34
+        targetSdk = 36
         versionCode = tauriProperties.getProperty("tauri.android.versionCode", "1").toInt()
         versionName = tauriProperties.getProperty("tauri.android.versionName", "1.0")
     }
     signingConfigs {
-        create("release") {
-            val keystorePropertiesFile = rootProject.file("keystore.properties")
-            val keystoreProperties = Properties()
-            if (keystorePropertiesFile.exists()) {
-                keystoreProperties.load(FileInputStream(keystorePropertiesFile))
+        if (keystorePropertiesFile.exists()) {
+            create("signing") {
+                keyAlias = keystoreProperties["keyAlias"] as String
+                keyPassword = keystoreProperties["password"] as String
+                storeFile = file(keystoreProperties["storeFile"] as String)
+                storePassword = keystoreProperties["password"] as String
             }
-
-            keyAlias = keystoreProperties["keyAlias"] as String
-            keyPassword = keystoreProperties["password"] as String
-            storeFile = file(keystoreProperties["storeFile"] as String)
-            storePassword = keystoreProperties["password"] as String
         }
     }
     buildTypes {
@@ -45,14 +46,26 @@ android {
             isDebuggable = true
             isJniDebuggable = true
             isMinifyEnabled = false
-            packaging {                jniLibs.keepDebugSymbols.add("*/arm64-v8a/*.so")
+            if (keystorePropertiesFile.exists()) {
+                signingConfig = signingConfigs.getByName("signing")
+            }
+            packaging {
+                jniLibs.keepDebugSymbols.add("*/arm64-v8a/*.so")
                 jniLibs.keepDebugSymbols.add("*/armeabi-v7a/*.so")
                 jniLibs.keepDebugSymbols.add("*/x86/*.so")
                 jniLibs.keepDebugSymbols.add("*/x86_64/*.so")
             }
         }
         getByName("release") {
-            signingConfig = signingConfigs.getByName("release")
+            isMinifyEnabled = true
+            if (keystorePropertiesFile.exists()) {
+                signingConfig = signingConfigs.getByName("signing")
+            }
+            proguardFiles(
+                *fileTree(".") { include("**/*.pro") }
+                    .plus(getDefaultProguardFile("proguard-android-optimize.txt"))
+                    .toList().toTypedArray()
+            )
         }
     }
     kotlinOptions {
@@ -68,13 +81,13 @@ rust {
 }
 
 dependencies {
-    implementation("androidx.webkit:webkit:1.6.1")
-    implementation("androidx.appcompat:appcompat:1.6.1")
-    implementation("androidx.activity:activity-ktx:1.9.3")
-    implementation("com.google.android.material:material:1.8.0")
+    implementation("androidx.webkit:webkit:1.14.0")
+    implementation("androidx.appcompat:appcompat:1.7.1")
+    implementation("androidx.activity:activity-ktx:1.10.1")
+    implementation("com.google.android.material:material:1.12.0")
     testImplementation("junit:junit:4.13.2")
     androidTestImplementation("androidx.test.ext:junit:1.1.4")
     androidTestImplementation("androidx.test.espresso:espresso-core:3.5.0")
 }
 
-apply(from = "tauri.build.gradle.kts")
+apply(from = "tauri.build.gradle.kts")

apps/readest-app/src-tauri/gen/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,147 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
+    <uses-permission android:name="com.android.vending.BILLING" />
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <!-- AndroidTV support -->
+    <uses-feature android:name="android.software.leanback" android:required="false" />
+
+    <application
+        android:icon="@mipmap/ic_launcher"
+        android:roundIcon="@mipmap/ic_launcher"
+        android:largeHeap="true"
+        android:enableOnBackInvokedCallback="false"
+        android:label="@string/app_name"
+        android:theme="@style/Theme.readest"
+        android:hardwareAccelerated="true"
+        android:usesCleartextTraffic="${usesCleartextTraffic}">
+        <activity
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode"
+            android:launchMode="singleTask"
+            android:label="@string/main_activity_title"
+            android:hardwareAccelerated="true"
+            android:name=".MainActivity"
+            android:exported="true">
+
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data android:scheme="content" />
+                <data android:scheme="file" />
+                <data android:mimeType="application/epub+zip" />
+                <data android:mimeType="application/pdf" />
+                <data android:mimeType="application/fb2" />
+                <data android:mimeType="application/x-fb2" />
+                <data android:mimeType="application/mobi"/>
+                <data android:mimeType="application/azw"/>
+                <data android:mimeType="application/azw3"/>
+                <data android:mimeType="application/x-mobipocket-ebook" />
+                <data android:mimeType="application/vnd.amazon.ebook" />
+                <data android:mimeType="application/vnd.amazon.mobi8-ebook" />
+                <data android:mimeType="application/vnd.comicbook+zip" />
+                <data android:mimeType="application/x-cbz" />
+                <data android:mimeType="application/zip" />
+                <data android:mimeType="text/plain" />
+                <data android:mimeType="application/octet-stream"/>
+                <data android:mimeType="application/x-font-ttf"/>
+                <data android:mimeType="application/x-font-otf"/>
+            </intent-filter>
+
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data android:scheme="content" />
+                <data android:scheme="file" />
+                <data android:mimeType="*/*" />
+                <data android:pathPattern=".*\\.epub" />
+                <data android:pathPattern=".*\\.pdf" />
+                <data android:pathPattern=".*\\.fb2" />
+                <data android:pathPattern=".*\\.fb2.zip" />
+                <data android:pathPattern=".*\\.mobi" />
+                <data android:pathPattern=".*\\.azw" />
+                <data android:pathPattern=".*\\.azw3" />
+                <data android:pathPattern=".*\\.cbz" />
+                <data android:pathPattern=".*\\.zip" />
+                <data android:pathPattern=".*\\.txt" />
+            </intent-filter>
+
+            <intent-filter>
+                <action android:name="android.intent.action.SEND"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+                <data android:mimeType="*/*"/>
+            </intent-filter>
+
+            <intent-filter>
+                <action android:name="android.intent.action.SEND_MULTIPLE"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+                <data android:mimeType="*/*"/>
+            </intent-filter>
+
+            <intent-filter android:label="oauth">
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="readest" android:host="auth-callback" />
+            </intent-filter>
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+                <!-- AndroidTV support -->
+                <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
+            </intent-filter>
+            <!-- DEEP LINK PLUGIN. AUTO-GENERATED. DO NOT REMOVE. -->
+            <intent-filter android:autoVerify="true" >
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="https" />
+                <data android:scheme="http" />
+                <data android:host="web.readest.com" />
+                
+                
+                
+                
+            </intent-filter>
+            <!-- DEEP LINK PLUGIN. AUTO-GENERATED. DO NOT REMOVE. -->
+        </activity>
+
+        <receiver
+            android:name="androidx.media.session.MediaButtonReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MEDIA_BUTTON" />
+            </intent-filter>
+        </receiver>
+
+        <service
+          android:name="com.readest.native_tts.MediaPlaybackService"
+          android:foregroundServiceType="mediaPlayback"
+          android:exported="true">
+          <intent-filter>
+            <action android:name="android.media.browse.MediaBrowserService"/>
+          </intent-filter>
+        </service>
+
+        <provider
+          android:name="androidx.core.content.FileProvider"
+          android:authorities="${applicationId}.fileprovider"
+          android:exported="false"
+          android:grantUriPermissions="true">
+          <meta-data
+            android:name="android.support.FILE_PROVIDER_PATHS"
+            android:resource="@xml/file_paths" />
+        </provider>
+    </application>
+</manifest>

apps/readest-app/src-tauri/gen/android/app/src/main/java/com/bilingify/readest/MainActivity.kt

@@ -2,32 +2,258 @@ package com.bilingify.readest
 
 import android.os.Build
 import android.os.Bundle
-import android.view.View
-import android.view.WindowInsets
-import android.view.WindowInsetsController
+import android.view.KeyEvent
+import android.view.MotionEvent
+import android.webkit.WebView
+import android.net.Uri
+import android.util.Log
+import android.content.Intent
+import android.graphics.Color
+import android.app.ActivityManager
+import android.content.res.Configuration
+import android.window.OnBackInvokedCallback
+import android.window.OnBackInvokedDispatcher
 import androidx.activity.enableEdgeToEdge
+import androidx.activity.OnBackPressedCallback
+import java.util.concurrent.CountDownLatch
+import java.util.concurrent.TimeUnit
+import java.util.concurrent.atomic.AtomicBoolean
+import app.tauri.plugin.JSArray
+import app.tauri.plugin.JSObject
+import com.readest.native_bridge.KeyDownInterceptor
+import com.readest.native_bridge.NativeBridgePlugin
+
+class MainActivity : TauriActivity(), KeyDownInterceptor {
+    private var wv: WebView? = null
+    private var interceptVolumeKeysEnabled = false
+    private var interceptBackKeyEnabled = false
+
+    override fun onWebViewCreate(webView: WebView) {
+        wv = webView
+    }
+
+    private val keyEventMap = mapOf(
+        KeyEvent.KEYCODE_BACK to "Back",
+        KeyEvent.KEYCODE_VOLUME_DOWN to "VolumeDown",
+        KeyEvent.KEYCODE_VOLUME_UP to "VolumeUp"
+    )
+
+    override fun interceptVolumeKeys(enabled: Boolean) {
+        Log.d("MainActivity", "Intercept volume keys: $enabled")
+        interceptVolumeKeysEnabled = enabled
+    }
+
+    override fun interceptBackKey(enabled: Boolean) {
+        Log.d("MainActivity", "Intercept back key: $enabled")
+        interceptBackKeyEnabled = enabled
+    }
+
+    override fun dispatchTouchEvent(event: MotionEvent): Boolean {
+        val action = when (event.actionMasked) {
+            MotionEvent.ACTION_DOWN -> "touchstart"
+            MotionEvent.ACTION_UP -> "touchend"
+            MotionEvent.ACTION_CANCEL -> "touchcancel"
+            MotionEvent.ACTION_POINTER_DOWN -> "touchstart"
+            MotionEvent.ACTION_POINTER_UP -> "touchend"
+            else -> null
+        }
+
+        action?.let { eventType ->
+            val pointerIndex = event.actionIndex
+            val pointerId = event.getPointerId(pointerIndex)
+            val x = event.getX(pointerIndex)
+            val y = event.getY(pointerIndex)
+            val pressure = event.getPressure(pointerIndex)
+
+            wv?.evaluateJavascript(
+                """
+                try {
+                    if (window.onNativeTouch) {
+                        window.onNativeTouch({
+                            type: "$eventType",
+                            pointerId: $pointerId,
+                            x: $x,
+                            y: $y,
+                            pressure: $pressure,
+                            pointerCount: ${event.pointerCount},
+                            timestamp: ${event.eventTime}
+                        });
+                    }
+                } catch (err) {
+                    console.error('Native touch error:', err);
+                }
+                """.trimIndent(),
+                null
+            )
+        }
+
+        return super.dispatchTouchEvent(event)
+    }
+
+    override fun dispatchKeyEvent(event: KeyEvent): Boolean {
+        if (event.action == KeyEvent.ACTION_DOWN) {
+            val keyCode = event.keyCode
+            val keyName = keyEventMap[keyCode]
+
+            if (keyName != null) {
+                val shouldIntercept = when (keyCode) {
+                    KeyEvent.KEYCODE_BACK -> interceptBackKeyEnabled
+                    KeyEvent.KEYCODE_VOLUME_UP, KeyEvent.KEYCODE_VOLUME_DOWN -> interceptVolumeKeysEnabled
+                    else -> false
+                }
+
+                if (shouldIntercept) {
+                    wv?.evaluateJavascript(
+                        """
+                        try { window.onNativeKeyDown("$keyName", $keyCode); } catch (_) {}
+                        """.trimIndent(),
+                        null
+                    )
+                    return true
+                }
+            }
+        }
+        return super.dispatchKeyEvent(event)
+    }
+
+    override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean {
+        val keyName = keyEventMap[keyCode]
+        if (keyName != null) {
+            wv?.evaluateJavascript(
+                """
+                try {
+                    window.onNativeKeyDown("$keyName", $keyCode)
+                } catch (err) {
+                    false
+                }
+                """.trimIndent()
+            ) { result ->
+              run {
+                if (result.equals("true", ignoreCase = true)) {
+                  Log.d("Key Event", "Key event $keyName intercepted")
+                }
+              }
+            }
+            return when (keyCode) {
+              KeyEvent.KEYCODE_VOLUME_UP, KeyEvent.KEYCODE_VOLUME_DOWN -> {
+                  if (interceptVolumeKeysEnabled) {
+                      true
+                  } else {
+                      super.onKeyDown(keyCode, event)
+                  }
+              }
+              KeyEvent.KEYCODE_BACK -> {
+                  if (interceptBackKeyEnabled) {
+                      true
+                  } else {
+                      super.onKeyDown(keyCode, event)
+                  }
+              }
+              else -> super.onKeyDown(keyCode, event)
+            }
+        }
+        return super.onKeyDown(keyCode, event)
+    }
 
-class MainActivity : TauriActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
         super.onCreate(savedInstanceState)
-	      
-        hideSystemUI()
+
+        handleIncomingIntent(intent)
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            setTaskDescription(
+                ActivityManager.TaskDescription(
+                    getString(R.string.app_name),
+                    null,
+                    Color.TRANSPARENT
+                )
+            )
+        }
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            onBackInvokedDispatcher.registerOnBackInvokedCallback(
+                OnBackInvokedDispatcher.PRIORITY_DEFAULT,
+                OnBackInvokedCallback {
+                    Log.d("MainActivity", "Back invoked callback triggered ${interceptBackKeyEnabled}")
+                    if (interceptBackKeyEnabled) {
+                        Log.d("MainActivity", "Back intercepted (OnBackInvokedCallback)")
+                        wv?.evaluateJavascript(
+                            """window.onNativeKeyDown("Back", ${KeyEvent.KEYCODE_BACK});""",
+                            null
+                        )
+                    } else {
+                        finish()
+                    }
+                }
+            )
+        }
+
+        onBackPressedDispatcher.addCallback(this,
+            object : OnBackPressedCallback(true) {
+                override fun handleOnBackPressed() {
+                    if (interceptBackKeyEnabled) {
+                        Log.d("MainActivity", "Back intercepted (OnBackPressedDispatcher)")
+                        wv?.evaluateJavascript(
+                            """window.onNativeKeyDown("Back", ${KeyEvent.KEYCODE_BACK});""",
+                            null
+                        )
+                    } else {
+                        isEnabled = false
+                        onBackPressedDispatcher.onBackPressed()
+                    }
+                }
+            }
+        )
     }
 
-    private fun hideSystemUI() {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-            window.decorView.windowInsetsController?.let { controller ->
-                controller.hide(WindowInsets.Type.systemBars())
-                controller.systemBarsBehavior = WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
+    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
+        super.onActivityResult(requestCode, resultCode, data)
+
+        NativeBridgePlugin.getInstance()?.handleActivityResult(requestCode, resultCode, data)
+    }
+
+    override fun onNewIntent(intent: Intent) {
+        super.onNewIntent(intent)
+        intent?.let { handleIncomingIntent(it) }
+    }
+
+    private fun handleIncomingIntent(intent: Intent) {
+        when (intent.action) {
+            Intent.ACTION_SEND -> {
+                if (intent.type != null) {
+                    handleSingleFile(intent)
+                }
             }
-        } else {
-            @Suppress("DEPRECATION")
-            window.decorView.systemUiVisibility = (
-                View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
-                        or View.SYSTEM_UI_FLAG_FULLSCREEN
-                        or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
-            )
+            Intent.ACTION_SEND_MULTIPLE -> {
+                if (intent.type != null) {
+                    handleMultipleFiles(intent)
+                }
+            }
+        }
+    }
+
+    private fun handleSingleFile(intent: Intent) {
+        val uri = intent.getParcelableExtra<Uri>(Intent.EXTRA_STREAM)
+        uri?.let { fileUri ->
+            val payload = JSObject().apply {
+                var urls = JSArray()
+                urls.put(fileUri.toString())
+                put("urls", urls)
+            }
+            NativeBridgePlugin.getInstance()?.triggerEvent("shared-intent", payload)
+        }
+    }
+
+    private fun handleMultipleFiles(intent: Intent) {
+        val uris = intent.getParcelableArrayListExtra<Uri>(Intent.EXTRA_STREAM)
+        uris?.let { fileUris ->
+            val payload = JSObject().apply {
+                var urls = JSArray()
+                fileUris.forEach { urls.put(it.toString()) }
+                put("urls", urls)
+            }
+            NativeBridgePlugin.getInstance()?.triggerEvent("shared-intent", payload)
         }
     }
 }

apps/readest-app/src-tauri/gen/android/app/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#3DDC84"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>

apps/readest-app/src-tauri/gen/android/app/src/main/res/drawable/splash_background.xml

@@ -0,0 +1,8 @@
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item>
+        <color android:color="#FF323130" />
+    </item>
+    <item android:gravity="center" android:width="120dp" android:height="120dp">
+        <bitmap android:src="@drawable/splash_icon" />
+    </item>
+</layer-list>

apps/readest-app/src-tauri/gen/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+  <background android:drawable="@color/ic_launcher_background"/>
+  <foreground>
+    <inset
+      android:drawable="@mipmap/ic_launcher_foreground"
+      android:inset="22%"/>
+  </foreground>
+</adaptive-icon>

apps/readest-app/src-tauri/gen/android/app/src/main/res/values/themes.xml

@@ -2,8 +2,13 @@
   <!-- Base application theme. -->
   <style name="Theme.readest" parent="Theme.MaterialComponents.DayNight.NoActionBar">
     <!-- Customize your theme here. -->
+    <item name="android:windowBackground">@drawable/splash_background</item>
+    <item name="android:statusBarColor">@android:color/transparent</item>
+    <item name="android:navigationBarColor">@android:color/transparent</item>
+    <item name="android:windowTranslucentStatus">false</item>
+    <item name="android:windowTranslucentNavigation">false</item>
+    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
+    <item name="android:fitsSystemWindows">false</item>
     <item name="android:windowActionBar">false</item>
-    <item name="android:windowNoTitle">true</item>
-    <item name="android:windowFullscreen">true</item>
   </style>
 </resources>

apps/readest-app/src-tauri/icons/android/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@mipmap/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+    <monochrome android:drawable="@mipmap/ic_launcher_monochrome"/>
+</adaptive-icon>