Merge pull request #1829 from rmcrackan/rmcrakan/13-4-2

incr ver

.editorconfig

@@ -0,0 +1,5 @@
+# https://editorconfig.org
+root = true
+
+[*.md]
+charset = utf-8

.github/ISSUE_TEMPLATE/bug_report.md

@@ -40,4 +40,6 @@ Attach your Libation log file here. If your user folder contains the file "Libat
 |macOS|`~/Library/Application Support/Libation`|
 |Linux|`~/.local/share/Libation`|
 
+**macOS:** If that folder does not exist because Libation never starts, try launching from Terminal and say whether it works: `/Applications/Libation.app/Contents/MacOS/Libation` (see [Troubleshooting for macOS](https://github.com/rmcrackan/Libation/blob/main/docs/advanced/troubleshoot.md#macos)).
+
 Alternative, you may open the log file folder from within Libation. Open Libation's settings, and on the first tab in Settings you can click the button 'Open log folder'. 

.github/download-icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/>
+  <polyline points="7 10 12 15 17 10"/>
+  <line x1="12" y1="15" x2="12" y2="3"/>
+</svg>

.github/labels.yml

@@ -0,0 +1,10 @@
+# Labels required by exempt-creators.yml and stale.yml. Sync with sync-labels workflow.
+# (Other repo labels are left unchanged when prune: false.)
+---
+- name: stale
+  color: 'eeeeee'
+  description: 'No activity for an extended period'
+
+- name: exempt
+  color: '0e8a16'
+  description: 'Excluded from automatic stale closure (e.g. maintainer-opened)'

.github/workflows/build-linux.yml

@@ -75,7 +75,7 @@ jobs:
           artifact=$(ls ./bundle)
           echo "artifact=${artifact}" >> "${GITHUB_OUTPUT}"
 
-      - uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v7
         with:
           name: ${{ steps.bundle.outputs.artifact }}
           path: ./bundle/${{ steps.bundle.outputs.artifact }}

.github/workflows/build-mac.yml

@@ -34,7 +34,7 @@ jobs:
       RUNTIME_ID: "osx-${{ inputs.architecture }}"
       WAIT_FOR_NOTARIZE: ${{ vars.WAIT_FOR_NOTARIZE == 'true' }}
     steps:    
-      - uses: apple-actions/import-codesign-certs@v5
+      - uses: apple-actions/import-codesign-certs@v7
         if: ${{ inputs.sign-app }}
         with: 
           p12-file-base64: ${{ secrets.DISTRIBUTION_SIGNING_CERT }}
@@ -85,18 +85,27 @@ jobs:
             WAIT="--wait"
           fi
           echo "::debug::Submitting the disk image for notarization"
-          RESPONSE=$(xcrun notarytool submit ./bundle/${{ steps.bundle.outputs.artifact }} $WAIT --no-progress --apple-id ${{ vars.APPLE_DEV_EMAIL }} --password ${{ secrets.APPLE_DEV_PASSWORD }} --team-id ${{ secrets.APPLE_TEAM_ID }} 2>&1)
-          SUBMISSION_ID=$(echo "$RESPONSE" | awk '/id: / { print $2;exit; }')
-          
+          # Capture stdout+stderr (2>&1). Use || true so that when notarytool fails (e.g. Apple TOS
+          # agreement required), the script does not exit before we can print RESPONSE—otherwise the
+          # job would fail with no visible error message in the workflow log.
+          RESPONSE=$(xcrun notarytool submit ./bundle/${{ steps.bundle.outputs.artifact }} $WAIT --no-progress --apple-id ${{ vars.APPLE_DEV_EMAIL }} --password ${{ secrets.APPLE_DEV_PASSWORD }} --team-id ${{ secrets.APPLE_TEAM_ID }} 2>&1) || true
           echo "$RESPONSE"
-          echo "::notice::Noraty Submission Id: $SUBMISSION_ID"
-          
+          SUBMISSION_ID=$(echo "$RESPONSE" | awk '/id: / { print $2;exit; }')
+          echo "::notice::Notary Submission Id: $SUBMISSION_ID"
+
+          # Re-fail the step if submit failed (e.g. no submission id). The job still fails, but the
+          # output above is now visible in the log so we can see the real error (e.g. sign agreement).
+          if [ -z "$SUBMISSION_ID" ]; then
+            echo "::error::Notarization submit failed. See output above for details (e.g. Apple TOS agreement)."
+            exit 1
+          fi
+
           if [ ${{ vars.WAIT_FOR_NOTARIZE == 'true' }} ]; then
             echo "::debug::Stapling the notarization ticket to the disk image"
             xcrun stapler staple "./bundle/${{ steps.bundle.outputs.artifact }}"
           fi
 
-      - uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v7
         with:
           name: ${{ steps.bundle.outputs.artifact }}
           path: ./bundle/${{ steps.bundle.outputs.artifact }}

.github/workflows/build-windows.yml

@@ -21,16 +21,21 @@ on:
 
 jobs:
   build:
-    name: "Windows-${{ matrix.release_name }}-x64"
+    name: "Windows-${{ matrix.release_name }}-${{ matrix.architecture }} (${{ matrix.ui }})"
     runs-on: windows-latest
     strategy:
       matrix:
         ui: [Avalonia]
+        architecture: [x64]
         release_name: [chardonnay]
         include:
-          - ui: WinForms
+          - architecture: x64
+            ui: WinForms
             release_name: classic
             prefix: Classic-
+          - architecture: arm64
+            ui: Avalonia
+            release_name: chardonnay
     steps:
       - uses: actions/checkout@v6
       
@@ -48,7 +53,7 @@ jobs:
         working-directory: ./Source
         run: |
           $PUBLISH_ARGS=@(
-            "--runtime", "win-x64",
+            "--runtime", "win-${{ matrix.architecture }}",
             "--configuration", "Release",
             "--output", "../bin",
             "-p:PublishProtocol=FileSystem",
@@ -70,11 +75,11 @@ jobs:
             "WindowsConfigApp.deps.json")
           
           foreach ($file in $delfiles){ if (test-path $file){ Remove-Item $file } }
-          $artifact="${{ matrix.prefix }}Libation.${{ inputs.libation-version }}-windows-${{ matrix.release_name }}-x64.zip"
+          $artifact="${{ matrix.prefix }}Libation.${{ inputs.libation-version }}-windows-${{ matrix.release_name }}-${{ matrix.architecture }}.zip"
           "artifact=$artifact" >> $env:GITHUB_OUTPUT
           Compress-Archive -Path * -DestinationPath "$artifact"
 
-      - uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v7
         with:
           name: ${{ steps.zip.outputs.artifact }}
           path: ./bin/${{ steps.zip.outputs.artifact }}

.github/workflows/deploy.yml

@@ -0,0 +1,69 @@
+name: Deploy VitePress site to Pages
+
+on:
+  # Runs on pushes targeting the `main` branch. Change this to `master` if you're
+  # using the `master` branch as the default branch.
+  push:
+    branches: [master]
+    paths:
+      - .github/workflows/deploy.yml
+      - docs/**
+      - .vitepress/**
+      - index.md
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0 # Not needed if lastUpdated is not enabled
+      # - uses: pnpm/action-setup@v4 # Uncomment this block if you're using pnpm
+      #   with:
+      #     version: 9 # Not needed if you've set "packageManager" in package.json
+      # - uses: oven-sh/setup-bun@v1 # Uncomment this if you're using Bun
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm # or pnpm / yarn
+      - name: Setup Pages
+        uses: actions/configure-pages@v6
+      - name: Install dependencies
+        run: npm ci # or pnpm install / yarn install / bun install
+      - name: Build with VitePress
+        run: npm run docs:build # or pnpm docs:build / yarn docs:build / bun run docs:build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: .vitepress/dist
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.github/workflows/docker.yml

@@ -29,21 +29,21 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+        uses: docker/setup-qemu-action@v4
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Login to Docker Hub
         if: ${{ inputs.release }}
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
         with:
           username: ${{ secrets.docker_username }}
           password: ${{ secrets.docker_token }}
 
       - name: Generate docker image tags
         id: metadata
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
         with:
           flavor: |
             latest=true
@@ -53,8 +53,10 @@ jobs:
             type=raw,value=${{ inputs.version }},enable=${{ inputs.release }}
 
       - name: Build and push image
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
+          # Avoid default git context refs/pull/*/merge (breaks after PR merge or on some re-runs).
+          context: .
           platforms: linux/amd64,linux/arm64
           push: ${{ steps.metadata.outputs.tags != ''}}
           cache-from: type=gha

.github/workflows/exempt-creators-backfill.yml

@@ -0,0 +1,67 @@
+# One-time or occasional backfill: add `exempt` to open issues/PRs opened by
+# rmcrackan or Mbucari that predate exempt-creators.yml. Run from Actions →
+# "Exempt creators backfill" → Run workflow.
+---
+name: Exempt creators backfill
+
+on:
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  backfill:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/github-script@v9
+        with:
+          script: |
+            const exemptLabel = 'exempt';
+            const creators = new Set(['rmcrackan', 'mbucari']);
+
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            const items = await github.paginate(github.rest.issues.listForRepo, {
+              owner,
+              repo,
+              state: 'open',
+              per_page: 100,
+            });
+
+            let labeled = 0;
+            let notCreator = 0;
+            let alreadyExempt = 0;
+
+            for (const item of items) {
+              const login = item.user && item.user.login;
+              if (!login || !creators.has(login.toLowerCase())) {
+                notCreator++;
+                continue;
+              }
+
+              const names = item.labels.map((l) => l.name);
+              if (names.some((n) => n.toLowerCase() === exemptLabel)) {
+                alreadyExempt++;
+                continue;
+              }
+
+              try {
+                await github.rest.issues.addLabels({
+                  owner,
+                  repo,
+                  issue_number: item.number,
+                  labels: [exemptLabel],
+                });
+                labeled++;
+              } catch (e) {
+                core.warning(`#${item.number}: ${e.message}`);
+              }
+            }
+
+            core.info(
+              `Backfill done: added exempt to ${labeled} item(s); ` +
+                `${alreadyExempt} already had exempt; ${notCreator} not from rmcrackan/Mbucari.`
+            );

.github/workflows/exempt-creators.yml

@@ -0,0 +1,39 @@
+# Assigns the `exempt` label to issues and PRs opened by maintainer accounts so
+# stale.yml does not mark them stale. See issue #1532.
+# For issues/PRs opened before this existed, run workflow "Exempt creators backfill".
+# Pattern: https://github.com/Asperguide/asper-header/blob/main/.github/workflows/exempt-creators.yml
+---
+name: Exempt specific creators
+
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    types: [opened]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  exempt:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add exempt label
+        if: >-
+          (github.event_name == 'issues' &&
+          contains(fromJSON('["rmcrackan","Mbucari"]'), github.event.issue.user.login)) ||
+          (github.event_name == 'pull_request' &&
+          contains(fromJSON('["rmcrackan","Mbucari"]'), github.event.pull_request.user.login))
+        uses: actions/github-script@v9
+        with:
+          script: |
+            const number = context.issue?.number || context.payload.pull_request?.number;
+            const repo = context.repo;
+            if (number) {
+              await github.rest.issues.addLabels({
+                ...repo,
+                issue_number: number,
+                labels: ['exempt'],
+              });
+            }

.github/workflows/release.yml

@@ -42,17 +42,17 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v8
         with:
           path: artifacts
           pattern: "*(Classic-)Libation.*"
 
       - name: Release
         id: release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           name: Libation ${{ needs.prerelease.outputs.version }}
-          body: <Put a body here>
+          body: "<Put a body here>"
           token: ${{ secrets.GITHUB_TOKEN }}
           draft: true
           prerelease: false

.github/workflows/stale.yml

@@ -0,0 +1,66 @@
+# Marks inactive issues/PRs stale and closes them after a further quiet period.
+# Exempt labels include `enhancement`, `exempt` (from exempt-creators.yml), and others below.
+# Pattern: https://github.com/Asperguide/asper-header/blob/main/.github/workflows/stale.yml
+---
+name: Close stale issues and PRs
+
+on:
+  schedule:
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v10
+        with:
+          days-before-stale: 30
+          days-before-close: 14
+          operations-per-run: 100
+
+          stale-issue-message: |
+            This issue has been automatically marked as stale because it has not had any activity for 30 days.
+
+            It will be closed in 14 days if no further activity occurs.
+
+            If this issue is still relevant, please leave a comment to keep it open.
+            Thank you for your contributions to Libation.
+
+          close-issue-message: |
+            This issue has been automatically closed due to inactivity.
+
+            If you believe this issue is still relevant, please reopen it or create a new issue with updated information.
+            Thank you for your understanding.
+
+          stale-issue-label: stale
+
+          stale-pr-message: |
+            This pull request has been automatically marked as stale because it has not had any activity for 30 days.
+
+            It will be closed in 14 days if no further activity occurs.
+
+            If you're still working on this PR, please leave a comment to keep it open.
+            Thank you for your contribution.
+
+          close-pr-message: |
+            This pull request has been automatically closed due to inactivity.
+
+            If you'd like to continue working on this, please reopen the PR or submit a new one.
+            Thank you for your contribution.
+
+          stale-pr-label: stale
+
+          exempt-issue-labels: 'priority: critical,priority: high,security,help wanted,good first issue,needs-discussion,enhancement,exempt'
+          exempt-pr-labels: 'priority: critical,priority: high,security,enhancement,exempt'
+
+          exempt-all-milestones: true
+          exempt-all-assignees: false
+          exempt-draft-pr: true
+          ascending: true
+          remove-stale-when-updated: true
+          debug-only: false

.github/workflows/sync-labels.yml

@@ -0,0 +1,29 @@
+# Ensures labels referenced by exempt-creators / stale workflows exist.
+# Optional per #1532 — run workflow_dispatch if labels are missing.
+# Pattern: https://github.com/Asperguide/asper-header/blob/main/.github/workflows/sync-labels.yml
+---
+name: Sync labels
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - '.github/labels.yml'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+
+jobs:
+  sync-labels:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Sync labels
+        uses: micnncim/action-label-syncer@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          manifest: .github/labels.yml
+          prune: false

.github/workflows/validate.yml

@@ -6,8 +6,14 @@ name: validate
 on:
   push:
     branches: [master]
+    paths:
+      - Source/**
+      - .github/workflows/**
   pull_request:
     branches: [master]
+    paths:
+      - Source/**
+      - .github/workflows/**
 
 jobs:
   get_version:

.gitignore

@@ -376,4 +376,9 @@ FodyWeavers.xsd
 .DS_Store
 
 # JetBrains Rider Settings
-**/.idea/
+**/.idea/
+
+# VitePress
+node_modules
+.vitepress/cache
+.vitepress/dist   

.releaseindex.json

@@ -1,7 +1,9 @@
 {
   "WindowsClassic":          "Classic-Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-win(?:dows)?-classic-x64\\.zip",
   "WindowsAvalonia":         "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-win(?:dows)?-chardonnay-x64\\.zip",
+  "WindowsAvalonia_Arm64":   "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-win(?:dows)?-chardonnay-arm64\\.zip",
   "LinuxAvalonia":           "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-amd64\\.deb",
+  "LinuxAvalonia_DEB":       "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-amd64\\.deb",
   "LinuxAvalonia_RPM":       "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-amd64\\.rpm",
   "MacOSAvalonia":           "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-macOS-chardonnay-x64\\.dmg",
   "LinuxAvalonia_Arm64":     "Libation\\.\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?-linux-chardonnay-arm64\\.deb",

.vitepress/config.js

@@ -0,0 +1,117 @@
+import { defineConfig } from "vitepress";
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  title: "Libation",
+  description:
+    "Libation: Liberate your Library - A free application for downloading your Audible audiobooks",
+  head: [["link", { rel: "icon", href: "/favicon.ico" }]],
+  cleanUrls: true,
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    logo: {
+      light: "/libation_logo_light.svg",
+      dark: "/libation_logo_dark.svg",
+    },
+
+    footer: {
+      message: "Released under the GPLv3 License",
+    },
+
+    editLink: {
+      pattern: "https://github.com/rmcrackan/Libation/edit/master/:path",
+    },
+
+    lastUpdated: true,
+
+    nav: [
+      { text: "Getting Started", link: "/docs/getting-started" },
+      { text: "Docs", link: "/docs/index" },
+      {
+        text: "Download",
+        link: "https://github.com/rmcrackan/Libation/releases/latest",
+      },
+      {
+        text: "Issues & Requests",
+        link: "https://github.com/rmcrackan/Libation/issues",
+      },
+      { text: "Donate", link: "https://www.paypal.com/paypalme/mcrackan" },
+    ],
+    sidebar: [
+      {
+        items: [
+          { text: "Overview", link: "/docs/index" },
+          { text: "Getting Started", link: "/docs/getting-started" },
+          { text: "FAQ", link: "/docs/frequently-asked-questions" },
+          {
+            text: "Issues & Requests",
+            link: "https://github.com/rmcrackan/Libation/issues",
+          },
+          { text: "Donate", link: "https://www.paypal.com/paypalme/mcrackan" },
+        ],
+      },
+      {
+        text: "Installation",
+        collapsed: false,
+        items: [
+          { text: "Linux", link: "/docs/installation/linux" },
+          { text: "Mac", link: "/docs/installation/mac" },
+          { text: "Docker", link: "/docs/installation/docker" },
+        ],
+      },
+      {
+        text: "Features",
+        collapsed: false,
+        items: [
+          {
+            text: "Audio File Formats",
+            link: "/docs/features/audio-file-formats",
+          },
+          { text: "Naming Templates", link: "/docs/features/naming-templates" },
+          {
+            text: "Searching & Filtering",
+            link: "/docs/features/searching-and-filtering",
+          },
+          {
+            text: "Easy guide to searching",
+            link: "/docs/features/lucene",
+          },
+        ],
+      },
+      {
+        text: "Advanced",
+        collapsed: false,
+        items: [
+          { text: "Advanced Topics", link: "/docs/advanced/advanced" },
+          { text: "Command Line Interface", link: "/docs/advanced/command-line-interface" },
+          { text: "Troubleshooting", link: "/docs/advanced/troubleshoot" }
+        ],
+      },
+      {
+        text: "Development",
+        collapsed: false,
+        items: [
+          {
+            text: "Getting Started",
+            link: "/docs/development/getting-started",
+          },
+          { text: "Contribute", link: "/docs/development/contribute" },
+          { text: "Website & Docs", link: "/docs/development/website" },
+          { text: "Linux Setup (Nix)", link: "/docs/development/nix-linux-setup" },
+        ],
+      },
+    ],
+
+    outline: {
+      level: "deep",
+    },
+
+    socialLinks: [
+      { icon: "github", link: "https://github.com/rmcrackan/Libation" },
+    ],
+
+    search: {
+      provider: "local",
+    },
+  },
+});

.vitepress/theme/DownloadSuggestionWidget.vue

@@ -0,0 +1,259 @@
+<script setup>
+import { ref, computed, onMounted, watch } from 'vue'
+import { getDetectOS } from './download-detection.js'
+
+const PREVIEW_OPTIONS = [
+  { value: '', label: 'Current system' },
+  { value: 'windows|x64', label: 'Windows (x64)' },
+  { value: 'windows|arm64', label: 'Windows (arm64)' },
+  { value: 'mac|x64', label: 'Mac (x64)' },
+  { value: 'mac|arm64', label: 'Mac (arm64)' },
+  { value: 'linux|x64|', label: 'Linux (x64)' },
+  { value: 'linux|x64|Ubuntu', label: 'Linux Ubuntu (x64)' },
+  { value: 'linux|x64|Fedora', label: 'Linux Fedora (x64)' },
+  { value: 'linux|arm64|', label: 'Linux (arm64)' },
+  { value: 'linux|arm64|Ubuntu', label: 'Linux Ubuntu (arm64)' },
+  { value: 'linux|arm64|Fedora', label: 'Linux Fedora (arm64)' },
+]
+
+const INSTALL_MAC_URL = 'https://getlibation.com/docs/installation/mac'
+const INSTALL_LINUX_URL = 'https://getlibation.com/docs/installation/linux'
+
+const status = ref('loading') // 'loading' | 'ready' | 'error'
+const errorMessage = ref('')
+const cachedAssets = ref([])
+const rec = ref(null)
+const blockHead = ref('')
+const previewValue = ref('')
+const installGuideUrl = ref(null)
+const installGuideLabel = ref('')
+const d = ref(null)
+
+function getPreviewOverrides() {
+  if (!previewValue.value) return null
+  const parts = previewValue.value.split('|')
+  const overrides = { os: parts[0], architecture: parts[1] }
+  if (parts.length > 2 && parts[2]) overrides.linuxFlavor = parts[2]
+  return overrides
+}
+
+function recommendedForLabel(overrides) {
+  if (!d.value) return 'Recommended download for your system'
+  const os = (overrides && overrides.os) || d.value.os
+  const ver = (overrides && overrides.osVersion) || d.value.osVersion
+  const arch = (overrides && overrides.architecture) || d.value.architecture
+  const flavor = (overrides && overrides.linuxFlavor !== undefined) ? overrides.linuxFlavor : d.value.linuxFlavor
+  if (os === 'windows') return 'Recommended download for Windows (' + arch + ')'
+  if (os === 'mac') return 'Recommended download for Mac ' + (ver ? ver + ' ' : '') + '(' + arch + ')'
+  if (os === 'linux') return 'Recommended download for ' + (flavor ? flavor + ' ' : '') + 'Linux (' + arch + ')'
+  return 'Recommended download for your system'
+}
+
+function updateRecommendation() {
+  if (!cachedAssets.value.length || !d.value) return
+  const overrides = getPreviewOverrides()
+  rec.value = d.value.recommendDownload(cachedAssets.value, overrides)
+  blockHead.value = recommendedForLabel(overrides)
+  const os = (overrides && overrides.os) || d.value.os
+  if (os === 'mac') {
+    installGuideUrl.value = INSTALL_MAC_URL
+    installGuideLabel.value = 'Install on macOS'
+  } else if (os === 'linux') {
+    installGuideUrl.value = INSTALL_LINUX_URL
+    installGuideLabel.value = 'Install on Linux'
+  } else {
+    installGuideUrl.value = null
+    installGuideLabel.value = ''
+  }
+}
+
+const showReasonWarn = computed(() => {
+  return rec.value?.reason && rec.value.reason !== 'Recommended for your system.'
+})
+
+const showAssets = computed(() => {
+  if (!rec.value || !d.value || status.value !== 'ready') return []
+  const libationAssets = cachedAssets.value
+  const overrides = getPreviewOverrides()
+  const os = (overrides && overrides.os) || d.value.os
+  const arch = (overrides && overrides.architecture) || d.value.architecture
+  return libationAssets.filter((a) => {
+    const p = d.value.parseAssetFilename(a.name)
+    if (!p) return false
+    if (os === 'windows' || os === 'mac' || os === 'linux') {
+      if (p.platform !== os) return false
+    }
+    if (arch === 'x64' || arch === 'arm64') {
+      if (p.arch !== arch) return false
+    }
+    return true
+  })
+})
+
+watch(previewValue, () => updateRecommendation())
+
+onMounted(() => {
+  d.value = getDetectOS()
+  fetch('https://api.github.com/repos/rmcrackan/Libation/releases/latest')
+    .then((res) => (res.ok ? res.json() : Promise.reject(new Error('Failed to load release'))))
+    .then((release) => {
+      cachedAssets.value = (release.assets || []).map((a) => ({
+        name: a.name,
+        url: a.browser_download_url,
+      }))
+      status.value = 'ready'
+      updateRecommendation()
+    })
+    .catch((err) => {
+      status.value = 'error'
+      errorMessage.value = err.message || 'Could not load latest release.'
+    })
+})
+</script>
+
+<template>
+  <div class="download-widget-wrapper">
+    <div v-if="status === 'loading'" class="download-widget recommended">
+      Loading latest release…
+    </div>
+    <div v-else-if="status === 'error'" class="download-widget recommended">
+      <p class="warn">{{ errorMessage }}</p>
+    </div>
+    <div v-else class="download-widget recommended">
+      <div class="block-head">
+        <svg class="icon-download" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+          <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4" />
+          <polyline points="7 10 12 15 17 10" />
+          <line x1="12" y1="15" x2="12" y2="3" />
+        </svg>
+        <span>{{ blockHead }}{{ rec?.windowsX64Choice ? ':' : rec?.recommended ? ':' : rec ? '.' : '' }}</span>
+        <select v-model="previewValue" aria-label="Find recommended download for" class="preview-select">
+          <option v-for="o in PREVIEW_OPTIONS" :key="o.value || 'current'" :value="o.value">
+            {{ o.label }}
+          </option>
+        </select>
+      </div>
+
+      <!-- Windows x64: Chardonnay + Classic -->
+      <template v-if="rec?.windowsX64Choice">
+        <ul class="widget-list">
+          <li><strong>Chardonnay</strong> (modern UI): <a :href="rec.windowsX64Choice.chardonnay.url" download>{{ rec.windowsX64Choice.chardonnay.name }}</a></li>
+          <li><strong>Classic</strong> (compact, screenreader-friendly): <a :href="rec.windowsX64Choice.classic.url" download>{{ rec.windowsX64Choice.classic.name }}</a></li>
+        </ul>
+        <p class="widget-link"><a :href="rec.classicVsChardonnayFaqUrl" target="_blank" rel="noopener">What's the difference between Classic and Chardonnay?</a></p>
+        <p v-if="showReasonWarn" class="warn">{{ rec.reason }}</p>
+      </template>
+
+      <!-- Single recommended -->
+      <template v-else-if="rec?.recommended">
+        <p class="widget-download"><a :href="rec.recommended.url" download>{{ rec.recommended.name }}</a></p>
+        <p v-if="installGuideUrl" class="widget-link">
+          <a :href="installGuideUrl" target="_blank" rel="noopener">{{ installGuideLabel }}</a>
+        </p>
+        <p v-if="showReasonWarn" class="warn">{{ rec.reason }}</p>
+        <div v-if="rec.alternatives?.length" class="alternatives">
+          {{ rec.alternatives.length === 1 ? 'Another option:' : 'Other options:' }}
+          <ul>
+            <li v-for="a in rec.alternatives" :key="a.name">
+              <a :href="a.url" download>{{ a.name }}</a>
+            </li>
+          </ul>
+        </div>
+      </template>
+
+      <!-- No match -->
+      <template v-else-if="rec">
+        <p class="warn">{{ rec.reason || 'Could not recommend a download.' }}</p>
+        <div class="alternatives">
+          Available:
+          <ul>
+            <li v-for="a in showAssets" :key="a.name">
+              <a :href="a.url" download>{{ a.name }}</a>
+            </li>
+          </ul>
+        </div>
+      </template>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.download-widget-wrapper {
+  margin: 1.5rem auto;
+  max-width: 42rem;
+}
+.download-widget.recommended {
+  background: var(--vp-c-bg-soft);
+  border: 1px solid var(--vp-c-divider);
+  padding: 0.75rem 1rem;
+  border-radius: 8px;
+  font-weight: 600;
+}
+.download-widget.recommended a {
+  color: var(--vp-c-brand-1);
+  text-decoration: underline;
+}
+.download-widget.recommended a:hover {
+  text-decoration: underline;
+  opacity: 0.8;
+}
+.block-head {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+  margin-bottom: 0.5rem;
+}
+.block-head .icon-download {
+  flex-shrink: 0;
+  width: 1.25rem;
+  height: 1.25rem;
+  color: var(--vp-c-brand-1);
+}
+.preview-select {
+  margin-left: auto;
+  font-size: 0.85rem;
+  padding-right: 1.75rem;
+  padding-left: 0.5rem;
+  appearance: none;
+  background-color: var(--vp-c-bg-soft);
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'%3E%3Cpath d='M6 9l6 6 6-6'/%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 0.35rem center;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 4px;
+  cursor: pointer;
+}
+.widget-list {
+  margin: 0 0 0 1rem;
+  padding-left: 0.5rem;
+}
+.widget-list li strong {
+  font-weight: 700;
+}
+.widget-download {
+  margin: 0.25rem 0;
+}
+.widget-link {
+  margin: 0.5rem 0 0;
+}
+.warn {
+  background: var(--vp-custom-block-warning-bg);
+  color: var(--vp-custom-block-warning-text);
+  padding: 0.5rem 0.75rem;
+  border-radius: 6px;
+  margin: 0.5rem 0 0;
+  font-size: 0.9rem;
+  font-weight: normal;
+}
+.alternatives {
+  font-size: 0.9rem;
+  font-weight: normal;
+  color: var(--vp-c-text-2);
+  margin-top: 0.5rem;
+}
+.alternatives ul {
+  margin: 0.25rem 0 0 1rem;
+  padding-left: 0.5rem;
+}
+</style>

.vitepress/theme/Layout.vue

@@ -0,0 +1,23 @@
+<script setup>
+import { ref, onMounted, defineAsyncComponent } from 'vue'
+import DefaultTheme from 'vitepress/theme'
+import { useData } from 'vitepress'
+
+const { frontmatter } = useData()
+const { Layout: DefaultLayout } = DefaultTheme
+const mounted = ref(false)
+onMounted(() => { mounted.value = true })
+
+// Load widget only on client so download-detection.js (navigator) never runs during SSR
+const DownloadSuggestionWidget = defineAsyncComponent(() =>
+  import('./DownloadSuggestionWidget.vue')
+)
+</script>
+
+<template>
+  <DefaultLayout>
+    <template #home-hero-after>
+      <DownloadSuggestionWidget v-if="frontmatter.layout === 'home' && mounted" />
+    </template>
+  </DefaultLayout>
+</template>

.vitepress/theme/custom.css

@@ -0,0 +1,24 @@
+/* Custom styles for Libation documentation */
+
+/* Naming Templates page: monospace in the doc column + outline only.
+   pageClass is applied to .Layout in VitePress; limit scope to #VPContent
+   so the top nav, sidebar, and site footer keep the default font. */
+.Layout.naming-templates-mono #VPContent,
+.Layout.naming-templates-mono #VPContent * {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
+    "Liberation Mono", "Courier New", monospace;
+}
+
+/* Hide certain nav items on tablet devices to prevent horizontal scroll */
+@media (min-width: 640px) and (max-width: 959px) {
+  /* Target specific nav items by their position */
+  /* Hide "Issues & Requests" and "Donate" links on tablet */
+  .VPNav .VPNavBar .nav .VPNavBarMenu .VPMenu:nth-child(3) {
+    display: none;
+  }
+
+  /* Alternative: Use a more specific selector if needed */
+  .VPNavBarMenuLink[href*="issues"] {
+    display: none;
+  }
+}

.vitepress/theme/download-detection.js

@@ -0,0 +1,196 @@
+/**
+ * Client-side OS and system detection for download recommendation.
+ * Uses navigator.userAgent and (when available) navigator.userAgentData.
+ * Call getDetectOS() in the browser only (e.g. in Vue onMounted).
+ */
+export function getDetectOS() {
+  const ua = typeof navigator !== 'undefined' ? navigator.userAgent : ''
+  const uaData = typeof navigator !== 'undefined' && navigator.userAgentData
+
+  function getOS() {
+    if (uaData?.platform) {
+      const p = uaData.platform.toLowerCase()
+      if (p === 'windows') return 'windows'
+      if (p === 'macos') return 'mac'
+      if (p === 'linux') return 'linux'
+      if (p === 'android') return 'android'
+      if (p === 'ios') return 'ios'
+    }
+    if (/\bWindows\b/i.test(ua)) return 'windows'
+    if (/\bMac\b/i.test(ua) || /\bMacintosh\b/i.test(ua)) return 'mac'
+    if (/\bLinux\b/i.test(ua) && !/\bAndroid\b/i.test(ua)) return 'linux'
+    if (/\bAndroid\b/i.test(ua)) return 'android'
+    if (/\b(iPhone|iPad|iPod)\b/i.test(ua)) return 'ios'
+    return 'other'
+  }
+
+  function getOSVersion() {
+    const os = getOS()
+    if (os === 'windows') {
+      const ntMatch = ua.match(/Windows NT (\d+\.\d+)/)
+      if (ntMatch) {
+        const nt = ntMatch[1]
+        if (nt === '10.0') return '10 or 11 (NT 10.0)'
+        if (nt === '6.3') return '8.1'
+        if (nt === '6.2') return '8'
+        if (nt === '6.1') return '7'
+        return `NT ${nt}`
+      }
+      return null
+    }
+    if (os === 'mac') {
+      const macMatch = ua.match(/Mac OS X (\d+[._]\d+(?:[._]\d+)?)/)
+      return macMatch ? macMatch[1].replace(/_/g, '.') : null
+    }
+    if (os === 'linux') {
+      const linuxMatch = ua.match(/Linux ([^\s;)]+)/)
+      return linuxMatch ? linuxMatch[1] : null
+    }
+    if (os === 'android') {
+      const m = ua.match(/Android (\d+(?:\.\d+)*)/)
+      return m ? m[1] : null
+    }
+    if (os === 'ios') {
+      const m = ua.match(/OS (\d+[._]\d+(?:[._]\d+)?)/)
+      return m ? m[1].replace(/_/g, '.') : null
+    }
+    return null
+  }
+
+  function getArchitecture() {
+    if (uaData?.architecture) {
+      const a = uaData.architecture.toLowerCase()
+      if (a === 'x86' || a === 'amd64') return a === 'amd64' ? 'x64' : 'x86'
+      if (a === 'arm' || a === 'arm64' || a === 'aarch64') return a === 'aarch64' ? 'arm64' : a
+      return a
+    }
+    if (/\b(aarch64|arm64|ARM64)\b/i.test(ua)) return 'arm64'
+    if (/\b(arm|aarch32)\b/i.test(ua) && !/arm64/i.test(ua)) return 'arm'
+    if (/\b(Wow64|Win64|x64|x86_64|amd64)\b/i.test(ua)) return 'x64'
+    if (/\b(WOW32|Win32|x86)\b/i.test(ua)) return 'x86'
+    return 'other'
+  }
+
+  function getLinuxFlavor() {
+    if (getOS() !== 'linux') return null
+    if (/\bUbuntu\b/i.test(ua)) return 'Ubuntu'
+    if (/\bFedora\b/i.test(ua)) return 'Fedora'
+    if (/\bDebian\b/i.test(ua)) return 'Debian'
+    if (/\bLinux Mint\b/i.test(ua)) return 'Linux Mint'
+    if (/\bOpenSUSE\b/i.test(ua)) return 'OpenSUSE'
+    if (/\bArch\b/i.test(ua)) return 'Arch'
+    if (/\bCentOS\b/i.test(ua)) return 'CentOS'
+    if (/\bRed Hat\b/i.test(ua)) return 'Red Hat'
+    if (/\bChrome OS\b/i.test(ua) || /\bCrOS\b/i.test(ua)) return 'Chrome OS'
+    return null
+  }
+
+  function parseAssetFilename(name) {
+    if (!name || typeof name !== 'string') return null
+    const lower = name.toLowerCase()
+    let platform = null
+    if (lower.includes('windows')) platform = 'windows'
+    else if (lower.includes('macos') || (lower.includes('mac') && !lower.includes('macos'))) platform = 'mac'
+    else if (lower.includes('linux')) platform = 'linux'
+    if (!platform) return null
+    let arch = null
+    if (lower.includes('arm64') || lower.includes('aarch64')) arch = 'arm64'
+    else if (lower.includes('amd64') || lower.includes('x64')) arch = 'x64'
+    else if (lower.includes('x86') || lower.includes('i386')) arch = 'x86'
+    if (!arch) return null
+    let packageType = null
+    if (lower.endsWith('.deb')) packageType = 'deb'
+    else if (lower.endsWith('.rpm')) packageType = 'rpm'
+    else if (lower.endsWith('.dmg')) packageType = 'dmg'
+    else if (lower.endsWith('.zip') || lower.endsWith('.msi')) packageType = 'archive'
+    return { platform, arch, packageType: packageType || 'unknown', name }
+  }
+
+  function recommendDownload(assets, overrides) {
+    const os = (overrides && overrides.os != null) ? overrides.os : getOS()
+    const arch = (overrides && overrides.architecture != null) ? overrides.architecture : getArchitecture()
+    const linuxFlavor = (overrides && overrides.linuxFlavor !== undefined) ? overrides.linuxFlavor : getLinuxFlavor()
+    let reason = ''
+    if (!Array.isArray(assets) || assets.length === 0) {
+      return { recommended: null, alternatives: [], reason: reason || 'No assets provided.' }
+    }
+    const wantArch = (arch === 'x64' || arch === 'x86') ? 'x64' : (arch === 'arm64' || arch === 'arm') ? 'arm64' : null
+    const wantOs = os === 'windows' ? 'windows' : os === 'mac' ? 'mac' : os === 'linux' ? 'linux' : null
+    const preferDeb = linuxFlavor === 'Ubuntu' || linuxFlavor === 'Debian' || linuxFlavor === 'Linux Mint' || linuxFlavor === 'Chrome OS'
+    const preferRpm = linuxFlavor === 'Fedora' || linuxFlavor === 'Red Hat' || linuxFlavor === 'CentOS' || linuxFlavor === 'OpenSUSE'
+    const parsed = []
+    for (let i = 0; i < assets.length; i++) {
+      const a = assets[i]
+      const name = a && (a.name != null ? a.name : a)
+      const url = a && a.url
+      const p = parseAssetFilename(name)
+      if (!p) continue
+      parsed.push({ name, url, parsed: p })
+    }
+    if (parsed.length === 0) {
+      return { recommended: null, alternatives: [], reason: reason || 'No recognizable asset filenames.' }
+    }
+    function score(entry) {
+      const p = entry.parsed
+      const nameLower = (entry.name || '').toLowerCase()
+      let s = 0
+      if (wantOs && p.platform === wantOs) s += 100
+      else if (wantOs) s -= 50
+      if (wantArch && p.arch === wantArch) s += 50
+      else if (wantArch) s -= 30
+      if (wantOs === 'linux' && p.packageType === 'deb' && preferDeb) s += 20
+      if (wantOs === 'linux' && p.packageType === 'rpm' && preferRpm) s += 20
+      if (wantOs === 'linux' && !preferDeb && !preferRpm && p.packageType === 'deb') s += 5
+      if (nameLower.includes('chardonnay')) s += 10
+      if (nameLower.includes('classic')) s -= 5
+      return s
+    }
+    parsed.sort((a, b) => score(b) - score(a))
+    const best = parsed[0]
+    const bestScore = score(best)
+    const recommended = bestScore >= 50 ? { name: best.name, url: best.url } : null
+    let altCandidates = parsed.slice(1, 4)
+    if (wantOs) altCandidates = altCandidates.filter(e => e.parsed.platform === wantOs)
+    if (wantArch) altCandidates = altCandidates.filter(e => e.parsed.arch === wantArch)
+    const alternatives = altCandidates.map(e => ({ name: e.name, url: e.url }))
+    const classicVsChardonnayFaqUrl = 'https://getlibation.com/docs/frequently-asked-questions#what-s-the-difference-between-classic-and-chardonnay'
+    let windowsX64Choice = null
+    if (wantOs === 'windows' && wantArch === 'x64') {
+      let winChardonnay = null
+      let winClassic = null
+      for (let j = 0; j < parsed.length; j++) {
+        const e = parsed[j]
+        if (e.parsed.platform !== 'windows' || e.parsed.arch !== 'x64') continue
+        const n = (e.name || '').toLowerCase()
+        if (n.includes('chardonnay')) winChardonnay = { name: e.name, url: e.url }
+        if (n.includes('classic')) winClassic = { name: e.name, url: e.url }
+      }
+      if (winChardonnay && winClassic) windowsX64Choice = { chardonnay: winChardonnay, classic: winClassic }
+    }
+    if (!recommended && wantOs) {
+      reason = 'No asset matched your system (OS: ' + os + ', arch: ' + arch + '). Try choosing a download manually.'
+    } else if (recommended && wantOs && !wantArch) {
+      reason = 'Matched your OS; architecture could not be detected. If this download is wrong, pick another (e.g. arm64 vs x64).'
+    }
+    return {
+      recommended,
+      alternatives,
+      reason: reason || (recommended ? 'Recommended for your system.' : ''),
+      windowsX64Choice,
+      classicVsChardonnayFaqUrl: windowsX64Choice ? classicVsChardonnayFaqUrl : null,
+    }
+  }
+
+  return {
+    os: getOS(),
+    osVersion: getOSVersion(),
+    architecture: getArchitecture(),
+    linuxFlavor: getLinuxFlavor(),
+    getOS,
+    getOSVersion,
+    getArchitecture,
+    getLinuxFlavor,
+    parseAssetFilename,
+    recommendDownload,
+  }
+}

.vitepress/theme/index.js

@@ -0,0 +1,8 @@
+import DefaultTheme from 'vitepress/theme'
+import Layout from './Layout.vue'
+import './custom.css'
+
+export default {
+  extends: DefaultTheme,
+  Layout,
+}

Directory.Build.props

@@ -0,0 +1,5 @@
+<Project>
+  <PropertyGroup>
+    <EnableMSTestRunner>true</EnableMSTestRunner>
+  </PropertyGroup>
+</Project>

Docker/liberate.sh

@@ -72,43 +72,70 @@ create_db() {
 }
 
 setup_db() {
-  DBPATH=$1
-  dbpattern="*.db"
+  local DBPATH=$1
+  local dbpattern="*.db"
+  local FILE LINK LINK_ORIGIN
+  local -a files
 
   debug "using database directory ${DBPATH}"
 
   # Figure out the right databse file
-  if [[ -z "${LIBATION_DB_FILE}" ]];
+  if [[ -z $LIBATION_DB_FILE ]]
   then
-    dbCount=$(find "${DBPATH}" -maxdepth 1 -type f -name "${dbpattern}" | wc -l)
-    if [ "${dbCount}" -gt 1 ];
-    then
-      error "too many database files found, set LIBATION_DB_FILE to the filename you wish to use"
-      exit 1
-    elif [ "${dbCount}" -eq 1 ];
-    then
-      files=( ${DBPATH}/${dbpattern} )
-      FILE=${files[0]}
-    else
-      FILE="${DBPATH}/LibationContext.db"
-    fi
+    shopt -s nullglob     # files shall be empty if no match is found
+    files=( "${DBPATH}"/${dbpattern} )
+    shopt -u nullglob
+
+    case ${#files[@]} in
+      0)
+        FILE="${DBPATH}/LibationContext.db"
+        ;;
+      1)
+        FILE="${files[0]}"
+        ;;
+      *)
+        debug "found ${#files[@]} database files matching '${dbpattern}'"
+        error "too many database files found, set LIBATION_DB_FILE to the filename you wish to use"
+        exit 1
+        ;;
+    esac
   else
     FILE="${DBPATH}/${LIBATION_DB_FILE}"
   fi
 
-  debug "planning to use database ${FILE}"
+  debug "planning to use database '${FILE}'"
 
-  if [ -f "${FILE}" ]; then
+  if [[ -f $FILE ]]
+  then
     info "database found at ${FILE}"
-  elif [ ${LIBATION_CREATE_DB} = "true" ];
+  elif [[ $LIBATION_CREATE_DB == "true" ]]
   then
     warn "database not found, creating one at ${FILE}"
-    create_db ${FILE}
+    create_db "${FILE}"
   else
     error "database not found and creation is disabled"
     exit 1
   fi
-  ln -s "${FILE}" "${LIBATION_CONFIG_INTERNAL}/LibationContext.db"
+
+  LINK="${LIBATION_CONFIG_INTERNAL}/LibationContext.db"
+  if [[ -L $LINK ]]
+  then
+    # check if the link is correct
+    LINK_ORIGIN=$(readlink -fn "$LINK")
+    if [[ $LINK_ORIGIN == $(readlink -fn "$FILE") ]]
+    then
+      warn "symlink '${LINK_ORIGIN}' to '${LINK}' already established"
+      return 0
+    fi
+    warn "removing existing symlink '${LINK_ORIGIN}' to '${LINK}'"
+    rm -f "$LINK"
+  elif [[ -e $LINK ]]
+  then
+    error "found blocking file at '${LINK}' - can't create symlink"
+    exit 1
+  fi
+
+  ln -s "${FILE}" "${LINK}"
 }
 
 run() {

Documentation/Advanced.md

@@ -1,159 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/advanced/advanced
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-
-# Advanced: Table of Contents
-
-- [Files and folders](#files-and-folders)
-- [Settings](#settings)
-- [Custom File Naming](NamingTemplates.md)
-- [Custom Theme Colors](#custom-theme-colors) (Chardonnay Only)
-- [Command Line Interface](#command-line-interface)
-- [Audio Formats (Dolby Atmos, Widevine, Spacial Audio)](AudioFileFormats.md)
-
-### Files and folders
-
-To make upgrades and reinstalls easier, Libation separates all of its responsibilities to a few different folders. If you don't want to mess with this stuff: ignore it. Read on if you like a little more control over your files.
-
-* In Libation's initial folder are the files that make up the program. Since nothing else is here, just copy new files here to upgrade the program. Delete this folder to delete Libation.
-
-* In a separate folder, Libation keeps track of all of the files it creates like settings and downloaded images. After an upgrade, Libation might think that's its being run for the first time. Just click ADVANCED SETUP and point to this folder. Libation will reload your library and settings.
-
-* The last important folder is the "books location." This is where Libation looks for your downloaded and decrypted books. This is how it knows which books still need to be downloaded. The Audible id must be somewhere in the book's file or folder name for Libation to detect your downloaded book.
-
-### Settings
-
-* Allow Libation to fix up audiobook metadata. After decrypting a title, Libation attempts to fix details like chapters and cover art. Some power users and/or control freaks prefer to manage this themselves. By unchecking this setting, Libation will only decrypt the book and will leave metadata as-is, warts and all.
-
-In addition to the options that are enabled if you allow Libation to "fix up" the audiobook, it does the following:
-
-* Adds the `TCOM` (`@wrt` in M4B files) metadata tag for the narrators.
-* Sets the `©gen` metadata tag for the genres.
-* Unescapes the copyright symbol (replace `©` with `©`)
-* Replaces the recording copyright `(P)` string with `℗`
-* Replaces the chapter markers embedded in the aax file with the chapter markers retrieved from Audible's API.
-* Sets the embedded cover art image with the 500x500 px cover art retrieved from Audible
-
-### Custom Theme Colors
-
-In Libation Chardonnay (not Classic), you may adjust the app colors using the built-in theme editor. Open the Settings window (from the menu bar: Settings > Settings). On the "Important" settings tab, click "Edit Theme Colors".
-
-#### Theme Editor Window
-
-The theme editor has a list of style names and their currently assigned colors. To change a style color, click on the color swatch in the left-hand column to open the color editor for that style. Observe the color changes in real-time on the built-in preview panel on the right-hand side of the theme editor.
-
-You may import or export themes using the buttons at the bottom-left of the theme editor.
-"Cancel" or closing the window will revert any changes you've made in the theme editor.
-"Reset" will reset any changes you've made in the theme editor.
-"Defaults" will restore the application default colors for the active theme ("Light" or "Dark")
-"Save" will save the theme colors to the ChardonnayTheme.json file and close the editor.
-
-Note: you may only edit the currently applied theme ("Light" or "Dark").
-
-#### Video Walkthrough
-The below video demonstrates using the theme editor to make changes to the Dark theme color pallet.
-
-[](https://github.com/user-attachments/assets/05c0cb7f-578f-4465-9691-77d694111349)
-
-### Command Line Interface
-
-Libationcli.exe allows limited access to Libation's functionalities as a CLI.
-
-Warnings about relying solely on on the CLI:
-* CLI will not perform any upgrades.
-* It will show that there is an upgrade, but that will likely scroll by too fast to notice.
-* It will not perform all post-upgrade migrations. Some migrations are only be possible by launching GUI.
-
-#### Help
-```console
-libationcli --help
-```
-#### Verb-Specific Help
-```console
-libationcli scan --help
-```
-#### Scan All Libraries
-```console
-libationcli scan
-```
-#### Scan Only Libraries for Specific Accounts
-```console
-libationcli scan nickname1 nickname2
-```
-#### Convert All m4b Files to mp3
-```console
-libationcli convert
-```
-#### Liberate All Books and Pdfs
-```console
-libationcli liberate
-```
-#### Liberate Pdfs Only
-```console
-libationcli liberate --pdf
-libationcli liberate -p
-```
-#### Force Book(s) to Re-Liberate
-```console
-libationcli liberate --force
-libationcli liberate -f
-```
-#### List Libation Settings
-```console
-libationcli get-setting
-libationcli get-setting -b
-libationcli get-setting FileDownloadQuality
-```
-#### Override Libation Settings for the Command
-```console
-libationcli liberate B017V4IM1G -override FileDownloadQuality=Normal
-libationcli liberate B017V4IM1G -o FileDownloadQuality=normal -o UseWidevine=true Request_xHE_AAC=true -f
-```
-#### Copy the Local SQLite Database to Postgres
-```console
-libationcli copydb --connectionString "my postgres connection string"
-libationcli copydb -c "my postgres connection string"
-```
-#### Export Library to File
-```console
-libationcli export --path "C:\foo\bar\my.json" --json
-libationcli export -p "C:\foo\bar\my.json" -j
-libationcli export -p "C:\foo\bar\my.csv" --csv
-libationcli export -p "C:\foo\bar\my.csv" -c
-libationcli export -p "C:\foo\bar\my.xlsx" --xlsx
-libationcli export -p "C:\foo\bar\my.xlsx" -x
-```
-#### Set Download Status
-Set download statuses throughout library based on whether each book's audio file can be found.   
-Must include at least one flag: --downloaded , --not-downloaded.  
-Downloaded: If the audio file can be found, set download status to 'Downloaded'.  
-Not Downloaded: If the audio file cannot be found, set download status to 'Not Downloaded'  
-UI: Visible Books \> Set 'Downloaded' status automatically. Visible books. Prompts before saving changes  
-CLI: Full library. No prompt
-
-```console
-libationcli set-status -d
-libationcli set-status -n
-libationcli set-status -d -n
-```
-#### Get a Content License Without Downloading
-```console
-libationcli get-license B017V4IM1G
-```
-#### Example Powershell Script to Download Four Differenf Versions f the Same Book
-```powershell
-$asin="B017V4IM1G"
-
-$xHE_AAC=@('true', 'false')
-$Qualities=@('Normal', 'High')
-foreach($q in $Qualities){
-  foreach($x in $xHE_AAC){
-	$license = ./libationcli get-license $asin --override FileDownloadQuality=$q --override Request_xHE_AAC=$x
-	echo $($license | ConvertFrom-Json).ContentMetadata.content_reference
-	echo $license | ./libationcli liberate --force
-  }
-}
-```
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/advanced/advanced.md))

Documentation/AudioFileFormats.md

@@ -1,104 +1,3 @@
-# Audio Formats Produced by Libation
-
-Libation will download audio in a number of different audio formats, depending on the settings you choose within Libation and the per-title availability of audio formats from Audible. The Libation settings which affect the format downloaded by Libation are shown in the Settings menu screenshot below.
-
-Notes:
-- Audiobook file extensions are either `.m4b` or `.mp3`. Libation uses the `.m4b` file extension for all non-MP3 files, regardless of the audio codec contained therein. Some media players don't recognize the `.m4b` file extension and may require the extension be changed to `.m4a` or `.mp4`.
-- Most (but not all) podcasts are delivered by Audible as native MP3 files. None of the following audio formats and settings discussions pertain to those podcasts because MP3s have no DRM, and those episodes are copied directly to their output folders.
-
-![Audio format settings menu](images/AudioFormatSettings.png)
-
-## Settings Summary
-### Audio quality to request from Audible
-Audiobooks can be requested from Audible as "Normal" quality or "High" quality, matching the settings in the Audible mobile apps. This setting affects the audio bitrate and, sometimes, the number of audio channels. This setting has no effect on the _audio codec_.
-
-### Use Widevine DRM
-When this setting is disabled, all audiobooks will be downloaded using Audible's in-house DRM (AAX(C)) in the [AAC-LC](#aac-lc) format.
-When this setting is enabled, Libation will request audio files protected by Google's Widevine Digital Rights Managements scheme, and two additional settings will be unlocked: [Request xHE-AAC Codec](#request-xhe-aac-codec) and [Request Spatial Audio](#request-spatial-audio) (explained further below).
-
-If you don't enable either of those additional options, then enabling 'Use Widevine DRM' will have no pratcical effect in nearly all circumstances. Audiobooks will be downloaded in the same [AAC-LC](#aac-lc) format with the same bitrate and the same number of audio channels. On rare occasions, enabling 'Use Widevine DRM' without the other two options will result in audio files with a different bitrate.
-
-### Request xHE-AAC Codec
-Enable this setting to request audiobooks in the [xHE-AAC](#xhe-aac) format. This codec is generally better quality than the [AAC-LC](#aac-lc) codec at the same bitrate, but it isn't as commonly supported by media players, so you may have some difficulty playing these audiobooks. The highest bitrate version of some audiobooks is only available as [xHE-AAC](#xhe-aac).
-
-### Request Spatial Audio
-Enable this setting to request audiobooks in a "spatial" ([Dolby Atmos](#dolby-atmos)) audio format. If an audiobook is not available in a spatial format, it will instead be downloaded in the [xHE-AAC codec](#xhe-aac).
-
-### Spatial audio codec
-Choose whether spatial audiobooks are downloaded in the [E-AC-3](#e-ac-3) or [AC-4](#ac-4) format.
-
-### Download my books in the original audio format (Lossless)
-If selected, Audiobooks will be downloaded and saved in the format delivered by audible (which depends on the settings explained above). Libation will not change the audio.
-
-### Download my books as .MP3 files (transcode if necessary).
-If selected, Libation will decode [AAC-LC](#aac-lc), [xHE-AAC](#xhe-aac), and [E-AC-3](#e-ac-3) audiobooks and re-encode them as MP3s using the MP3 encoder settings ([read about LAME MP3 encoder settings](https://lame.sourceforge.io/lame_ui_example.php)). Note that Libation cannot convert [AC-4](#ac-4) audio to MP3.
-
-# Audio Formats
-
-## Traditional Mono and Stereo Formats
-
-### AAC-LC
-#### _Full Name_
-Advanced Audio Coding - Low Complexity
-#### _Description_
-This is the base profile for AAC audio and has existed since AAC's initial release in 1997. It enjoys wide support on nearly every conceivable platform capable of playing digital audio, as ubiquitous as MP3.
-If Widevine support is not enabled, or if the book is not available in the more high-definition formats, Libation will download audiobooks in this format.
-
-### MP3
-#### _Full Name_
-MPEG-1 Audio Layer III or MPEG-2 Audio Layer III
-#### _Description_
-An older (released in 1991) but still nearly universally supported audio codec. Its audio quality is generally worse than AAC-LC at similar bitrates. Audible delivers some podcasts in MP3 format, but no audiobooks are natively availble as MP3. Libation supports converting Audiobooks delivered in other audio formats to MP3. Note that the MP3 format supports a maximum of two audio channels, so multichannel E-AC-3 audio will be downsampled to stereo or mono (depending on the Libation's settings). [AC-4](#ac-4) cannot be converted to MP3.
-
-### xHE-AAC
-#### _Full Name_
-Extended High-Efficiency Advanced Audio Coding
-#### _Description_
-This is a proprietary codec created by the [Fraunhofer Institute for Integrated Circuits IIS](https://www.iis.fraunhofer.de/en/ff/amm/broadcast-streaming/xheaac.html). It combines features of the HE-AAC v2 and the baseline USAC (Unified Speech and Audio Coding) profiles with the parts of the MPEG-D DRC Loudness Control Profile or Dynamic Range Control Profile. Therefore, USAC and xHE-AAC are not synonymous and should not be used interchangeably. A player capable of decoding USAC will not necessarily be able to decode xHE-AAC.
-
-xHE-AAC boasts significantly higher quality audio at low bitrates. Though it has existed since at least 2016, playback support is still quite limited. FFmpeg has recently added partial decoder support for the USAC profiles, but it is insufficient to decode the xHE-AAC audio files acquired from Audible (due to FFmpeg's lack of support for MPEG Surround for Mono to Stereo Upmixing; ISO 23003-3:2012 §7.11)
-
-Note that the xHE-AAC files authored by Audible have some USAC conformance errors including:
-- Number of samples per frame not matching the UsacConfig coreCoderFrameLength value.
-- Disagreement between stts and UsacFrame usacIndependencyFlag value.
-- Stts indicating a frame is an immediate play-out frame, but USAC AudioPreRoll is absent.
-
-## Dolby Atmos
-Atmos is a surround sound technology that expands on existing surround sound systems by adding height channels as well as free-moving sound objects. Audible delivers Dolby Atmos in two formats: E-AC-3 and AC-4.
-
-Your device's ability to play audio from these formats does not necessarily mean that the audio you are hearing is Atmos (spatial). For instance, downloading the AC-4 codec for Windows ([links in the [Supported media Players](#supported-media-players) section) will enable you to play AC-4 audiobooks, but you'll still need to download [Dolby Access](https://apps.microsoft.com/detail/9n0866fs04w8?hl=en-US&gl=US) and pay $15 to enable _Dolby Atmos For Headphones_. Please refer to [this comment](https://github.com/rmcrackan/Libation/pull/1331#discussion_r2268660524) for additional context.
-
-### E-AC-3
-#### _Full Name_
-Dolby Digital Plus (a.k.a Enhanced AC-3, DDP, DD+, and EC-3)
-#### _Description_
-A proprietary digital audio compression scheme developed by Dolby Digital for the transport and storage of multichannel audio. This format can be extended to add support for Atmos, making the codec _Dolby Digital Plus Atmos_. _Dolby Digital Plus Atmos_ is backwards compatible with Dolby Digital Plus, so any media player capable of playing Dolby Digital Plus can play _Dolby Digital Plus Atmos_. Audible spatial audiobooks downloaded in the E-AC-3 format are _Dolby Digital Plus Atmos_. If they are played by a media player that supports Atmos, they will play as Atmos audio. If they are played by a media player that does not support Atmos, they will be played as traditional 5.1 surround audio.
-
-### AC-4
-#### _Full Name_
-Dolby AC-4
-#### _Description_
-A proprietary audio compression technology developed by Dolby Digital for the transport and storage of audio channels and/or audio objects. Audible spatial audiobooks downloaded in the AC-4 format are 2-channel AC-4 Immersive Stereo (AC4-IMS) audio, intended for playback in headphones or earbuds (though apparently [not supported on Apple devices](https://github.com/rmcrackan/Libation/issues/996#issuecomment-3169574514)).
-
-# Supported Media Players
-Below is an incomplete matrix of codec support across various media players and platforms.
-| Player | [AAC-LC](#aac-lc) | [xHE-AAC](#xhe-aac) | [E-AC-3](#e-ac-3) | [AC-4](#ac-4) |
-| :--- | :---: | :---: | :---: | :---: |
-|Windows Native Support|Yes|Yes<sup>1</sup>|Yes<sup>2,3</sup>|Yes<sup>4</sup>|
-|macOS Native Support|Yes|Yes|Yes<sup>3</sup>| |
-|Android Native Support<sup>5</sup>|Yes|Yes| | |
-|FFmpeg (all platforms)|Yes|Yes<sup>6</sup>|Yes<sup>3</sup>||
-|[VLC](https://www.videolan.org/vlc/) (Windows)|Yes| |Yes<sup>3</sup> | |
-|[foobar2000](https://www.foobar2000.org/components) (Windows and Mac)|Yes|Yes<sup>7</sup> | | |
-|[PotPlayer](https://potplayer.daum.net/) (Windows)|Yes|Yes|Yes<sup>3</sup>| |
-|[Samsung Media Player](https://play.google.com/store/apps/details?id=com.sec.android.app.music)<sup>8</sup> (Samsung devices) |Yes|Yes|Yes|Yes|
-
-1. Windows 11 22H2 and later
-2. On Windows [prior to Windows 11, version 24H2](https://support.microsoft.com/en-us/windows/codecs-in-media-player-d5c2cdcd-83a2-4805-abb0-c6888138e456). You can still get the codec by running the following command from a Windows PowerShell console: `winget install --id 9nvjqjbdkn97`
-3. As mentioned in the [Dolby Atmos](#dolby-atmos) section, just because a media player can play a file does not mean it's rendering Atmos. _Dolby Digital Plus Atmos_ is backwards compatible with _Dolby Digital Plus_, so media players which only support _Dolby Digital Plus_ will play E-AC-3 audio files as regular 5.1 surround without rendering the Atmos spatial qualities. Additional software or hardware support may be required for Dolby Atmos playback.
-4. You can download the AC-4 codec for Windows from 3rd party sites like [Major Geeks](https://www.majorgeeks.com/files/details/dolby_ac_3ac_4_installer.html) and [Free-Codecs](https://www.free-codecs.com/dolby-ac-4-decoder_download.htm). Once you install the codec bundle from one of those sources, the Windows store app will keep it updated. Read more about the process [in this comment](https://github.com/rmcrackan/Libation/pull/1331#discussion_r2268660524).
-5. All Android devices will support AAC-LC and xHE-AAC. Some manufactures (such as Samsung) will include Dolby codecs for playing E-AC-3 and AC-4 audio.
-6. requires FFmpeg to be [built with fdk-aac](https://trac.ffmpeg.org/wiki/Encode/AAC#fdk_aac). You will almost certainly not find pre-build binaries in the wild due to licensing restrictions.
-7. Requires the [fdk-aac plugin](https://www.foobar2000.org/components/view/foo_pd_aac) (Windows only)
-8. Requires audio file extensions to be `.m4a` or `.mp4`. Libation sets the file extensions to `.m4b`, so you must manually change it to `.m4a` by renaming the audio file.
+# This page has been moved to https://getlibation.com/docs/features/audio-file-formats
 
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/features/audio-file-formats.md))

Documentation/Docker.md

@@ -1,76 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/installation/docker
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-> [!WARNING]
-> ## Breaking Changes
-> * The docker image now runs as user 1001 and group 1001. Make sure that the permissions on your volumes allow user 1001 to read and write to them or see the User section below for other options, or if you're not sure.
-> * `SLEEP_TIME` is now set to `-1` by default. This means the image will run once and exit. If you were relying on the previous default, you'll need to explicitly set the `SLEEP_TIME` environment variable to `30m` to replicate the previous behavior.
-> * The docker image now ignores the values in `Settings.json` for `Books` and `InProgress`. You can now change the folder that books are saved to by using the `LIBATION_BOOKS_DIR` environment variable.
-
-# Disclaimer
-The docker image is provided as-is. We hope it can be useful to you but it is not officially supported.
-
-### Configuration
-Configuration in Libation is handled by two files, `AccountsSettings.json` and `Settings.json`. These files can usually be found in the Libation folder in your user's home directory. The easiest way to configure these is to run the desktop version of Libation and then copy them into a folder, such as `/opt/libation/config`, that you'll volume mount into the image. `Settings.json` is technically optional, and, if not provided, Libation will run using the default settings. Additionally, the `Books` and `InProgress` settings in `Settings.json` will be ignored and the image will instead substitute it's own values.
-
-### Running
-Once the configuration files are copied, the docker image can be run with the following command.
-```
-sudo docker run -d \
-  -v /opt/libation/config:/config \
-  -v /opt/libation/books:/data \
-  --name libation \
-  --restart=always \
-  rmcrackan/libation:latest
-```
-
-By default the container will scan for new books once and download any new ones. This is configurable by passing in a value for the `SLEEP_TIME` environment variable. For example, if you pass in `10m` it will keep running, scan for new books, and download them every 10 minutes.
-
-```
-sudo docker run -d \
-  -v /opt/libation/config:/config \
-  -v /opt/libation/books:/data \
-  -e SLEEP_TIME='10m' \
-  --name libation \
-  --restart=always \
-  rmcrackan/libation:latest
-```
-
-### Environment Variables
-| Env Var  | Default | Description |
-| -------- | ------- | ----------- |
-| SLEEP_TIME  | -1 | Length of time to sleep before doing another scan/download. Set to -1 to run one. |
-| LIBATION_BOOKS_DIR | /data | Folder where books will be saved |
-| LIBATION_CONFIG_DIR | /config | Folder to read configuration from. |
-| LIBATION_DB_DIR    | /db | Optional folder to load database from. If not mounted, will load database from `LIBATION_CONFIG_DIR`. |
-| LIBATION_DB_FILE | | Name of database file to load. By default it will look for all `.db` files and load one if there is only one present. |
-| LIBATION_CREATE_DB | true | Whether or not the image should create a database file if none are found. |
-
-### User
-This docker image runs as user `1001`. In order for the image to function properly, user `1001` must be able to read and write the volumes that are mounted in. If they are not, you will see errors, including [sqlite error](#1060), [Microsoft.Data.Sqlite.SqliteException](#1110), [unable to open database file](#1113), [Microsoft.EntityFrameworkCore.DbUpdateException](#1049)
-
-If you're not sure what your user number is, check the output of the `id` command. Docker should normally run with the number of the user who configured and ran it.
-
-If you want to change the user the image runs as, you can specify `-u <uid>:<gid>`. For example, to run it as user `2000` and group `3000`, you could do the following:
-
-```
-sudo docker run -d \
-  -u 2000:3000 \
-  -v /opt/libation/config:/config \
-  -v /opt/libation/books:/data \
-  --name libation \
-  --restart=always \
-  rmcrackan/libation:latest
-```
-
-If the user it's running as is correct, and it still cannot write, be sure to check whether the files and/or folders might be owned by the wrong user. You can use the `chown` command to change the owner of the file to the correct user and group number, for example: `chown -R 1001:1001 /mnt/audiobooks /mnt/libation-config`
-
-### Advanced Database Options
-The docker image supports an optional database mount location defined by `LIBATION_DB_DIR`. This allows the database to be mounted as read/write, while allowing the rest of the configuration files to be mounted as read only. This is specifically useful if running in Kubernetes where you can use Configmaps and Secrets to define the configuration. If the `LIBATION_DB_DIR` is mounted, it will be used, otherwise it will look for the database in `LIBATION_CONFIG_DIR`. If it does not find the database in the expected location, it will attempt to make an empty database there.
-
-### Getting help
-As mentioned above: docker is not officially supported. I'm adding this at the bottom of the page for anyone serious enough to have read this far. If you've tried everything above and would still like help, you can open an [issue](https://github.com/rmcrackan/Libation/issues). Please include `[docker]` in the title. There are also some docker folks who have offered occasional assistance who you can tag within your issue: `@ducamagnifico` , `@wtanksleyjr` , `@CLHatch`.
-
-**Reminder** that these are just friendly users who are sometimes around. They're *not* our customer support.
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/installation/docker.md))

Documentation/FrequentlyAskedQuestions.md

@@ -1,56 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/frequently-asked-questions
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-
-# Frequently Asked Questions
-
-## Q: Where can I get help for my specific problem?
-
-**A:** [You can open an issue here](https://github.com/rmcrackan/Libation/issues) for bug reports, feature requests, or specialized help.
-
-## Q: What's the difference between 'Classic' and 'Chardonnay'?
-
-**A:** First and most importantly: Classic and Chardonnay have the exact same features.
-
-* **Classic** is Windows only. Its older 'grey boxes' look has a compact design which allows for more information on the screen. Notably, Classic was written using an older, more mature technology which has built-in support for screenreaders.
-
-* **Chardonnay** is available for Windows, Mac, and Linux. Its modern design has a more open look and feel.
-
-## Q: Now that I've downloaded my books, how can I listen to them?
-
-**A:** You can use any app which plays m4b files (or mp3 files if you used that setting). Here are just a few ideas. Disclaimer: I have no affiliation with any of these companies:
-
-* iOS: [BookPlayer](https://apps.apple.com/us/app/bookplayer/id1138219998)
-* iOS: [Bound](https://apps.apple.com/us/app/bound-audiobook-player/id1041727137)
-* Android: [Smart AudioBook Player](https://play.google.com/store/apps/details?id=ak.alizandro.smartaudiobookplayer&hl=en_US&gl=US)
-* Android: [Listen](https://play.google.com/store/apps/details?id=ru.litres.android.audio&hl=en_US&gl=US)
-* Desktop: [VLC](https://www.videolan.org/)
-* Windows Desktop: [Audibly](https://github.com/rstewa/Audibly) -- a desktop player build specifically for audiobooks
-
-Self-hosting online:
-
-* [audiobookshelf](https://www.audiobookshelf.org). On [reddit](https://www.reddit.com/r/audiobookshelf/)
-* [plex](https://www.plex.tv/). Listen with [Prologue](https://prologue.audio/) (iOS)
-
-## Q: I'm having trouble playing my non-spatial audiobook, how can I fix this?
-
-**A:** If you enabled the [Request xHE-AAC Codec](AudioFileFormats.md#request-xhe-aac-codec) option in settings, then the audiobook is being downloaded in the [xHE-AAC codec](AudioFileFormats.md#xhe-aac) which isn't widely supported. You have two options:
-1. Use a media player which supports the xHE-AAC codec. [See an incomplete list of media players which support xHE-AAC](AudioFileFormats.md#supported-media-players).
-2. Disable the [Request xHE-AAC Codec](AudioFileFormats.md#request-xhe-aac-codec) option in settings and re-download the audiobook. This will cause Libation to download audiobooks in the [AAC-LC codec](AudioFileFormats.md#aac-lc), which enjoys near-universal media player support.
-
-## Q: I'm having trouble playing my book with 4D, spatial audio, or Dolby Atmos, how can I fix this?
-
-**A:** Spatial audiobooks are delivered in two formats: [E-AC-3](AudioFileFormats.md#e-ac-3) and [AC-4](AudioFileFormats.md#ac-4). [See an incomplete list of media players which support those codecs](AudioFileFormats.md#supported-media-players).
-
-## Q: I'm having trouble loggin into my Brazil account.
-
-**A:** For reasons known only to Jeff Bezos and God, amazon and audible brazil handle logins slightly differently. The external browser login option is not possible for Brazil. [See this ticket for more details.](https://github.com/rmcrackan/Libation/issues/1103)
-
-## Q: How do I use Libation with a South Africa account?
-
-**A:** Like many countries, amazon gives South Africa it's own amazon site. [Unlike many other regions](https://www.audible.com/ep/country-selector) there is not South Africa specific audible site. Use `US` for your region -- ie: audible.com.
-
-(Not exactly a *frequently* asked question but it's come up more than once)
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/frequently-asked-questions.md))

Documentation/GettingStarted.md

@@ -1,155 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/getting-started
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-
-# Getting started: Table of Contents
-
-- [Download Libation](#download-libation-1)
-- [Installation](#installation)
-- [Create Accounts](#create-accounts)
-- [Import your library](#import-your-library)
-- [Download your books -- DRM-free!](#download-your-books----drm-free)
-- [Download PDF attachments](#download-pdf-attachments)
-- [Details of downloaded files](#details-of-downloaded-files)
-- [Export your library](#export-your-library)
-- [I still need help](#i-still-need-help)
-
-
-
-### [Download Libation](https://github.com/rmcrackan/Libation/releases)
-
-##### Which version? Chardonnay vs Classic
-
-Nearly 100% of the difference is look and feel -- it's a matter of preference.
-
-Chardonnay has an updated look and will work and look the same on Windows, Mac, and Linux.  
-Classic is Windows only. It has an older look because it's built with older, duller, and more mature technology. This tech has built into it better support for things like accessibility for screen readers.
-
-### Installation
-
-* Windows
-
-Extract the zip file to a folder and then run `Libation.exe` from inside of that folder. Do not put it in Program Files. The inability to edit files from there causes problems with configuration and updating.
-
-* [Linux](InstallOnLinux.md)
-* [MacOS](InstallOnMac.md)
-
-### Create Accounts
-
-Create your account(s):
-
-![Create your accounts, menu](images/v40_accounts.png)
-
-New locale options include many more regions including old audible accounts which pre-date the amazon acquisition
-
-![Choose your account locales](images/v40_locales.png)
-
-### Import your library
-
-Be default, Libation will periodically scan the accounts you added above with a checkbox next to them. Nothing for you to do. You can also scan manually.
-
-Select Import > Scan Library:
-
-![Import step 1](images/Import1.png)
-
-Or if you have multiple accounts, you'll get to choose whether to scan all accounts or just the ones you select:
-
-![Import which accounts](images/v40_import.png)
-
-If this is a new installation, or you're scanning an account you haven't scanned before, you'll be prompted to enter your password for the Audible account.
-
-![Login password](images/alt-login1.png)
-
-Enter the password and click Submit. Audible will prompt you with a CAPTCHA image. 
-
-![Login captcha](images/alt-login2.png)
-
-Enter the CAPTCHA answer characters and click Submit. If all has gone well, Libation will start scanning the account. 
-
-In rare instances, the Captcha image/response will fail in an endless loop. If this happens, delete the problem account, and then click Save. Re-add the account and click Save again. Now try to scan the account again. This time, instead of typing your password, click the link that says "Or click here". This will open the Audible External Login dialog shown below.
-
-![Login alternative setup](images/alt-login3.png)
-
-You can either copy the URL shown and paste it into your browser or launch the browser directly by clicking Launch in Browser. Audible will display its standard login page. Login, including answering the CAPTCHA on the next page. In some cases, you might have to approve the login from the email account associated with that login, but once the login is successful, you'll see an error message.
-
-![Login alternative login result](images/alt-login4.png)
-
-This actually means you've successfully logged in. Copy the entire URL shown in your browser and return to Libation. Paste that URL into the text box at the bottom of the Audible External Login window and click Submit.
-
-You'll see this window while it's scanning:
-
-![Import step 2](images/Import2.png)
-
-Success! We see how many new titles are imported:
-
-![Import step 3](images/Import3.png)
-
-### Download your books -- DRM-free!
-
-Automatically download some or all of your audible books. This shows you how much of your library is not yet downloaded and decrypted:
-
-The stoplights will tell you a title's status:
-
-* Green: downloaded and decrypted
-* Yellow: downloaded but still encrypted with DRM
-* Red: not downloaded
-* PDF icon without arrow: downloaded
-* PDF with arrow: not downloaded
-
-Or hover over the button to see the status.
-
-![Liberate book step 1](images/LiberateBook1.png)
-
-Select Liberate > Begin Book Backups
-
-You can also click on the stop light to download only that title and its PDF
-
-![Liberate book step 2](images/LiberateBook2.png)
-
-First the original book with DRM is downloaded
-
-![Liberate book step 3](images/LiberateBook3.png)
-
-Then it's decrypted so you can use it on any device you choose. The very first time you decrypt a book, this step will take a while. Every other book will go much faster. The first time, Libation has to figure out the special decryption key which allows your personal books to be unlocked.
-
-![Liberate book step 4](images/LiberateBook4.png)
-
-And voila! If you have multiple books not yet liberated, Libation will automatically move on to the next.
-
-![Liberate book step 5](images/LiberateBook5.png)
-
-The Audible id must be somewhere in the book's file or folder name for Libation to detect your downloaded book.
-
-### Download PDF attachments
-
-For books which include PDF downloads, Libation can download these for you as well and will attempt to store them with the book. "Book backup" will already download an available PDF. This additional option is useful when Audible adds a PDF to your book after you've already backed it up.
-
-Select Liberate > Begin PDF Backups
-
-![PDF download step 2](images/PdfDownload2.png)
-
-The downloads work just like with books, only with no additional decryption needed.
-
-![PDF download step 3](images/PdfDownload3.png)
-
-### Details of downloaded files
-
-![Post download](images/PostDownload.png)
-
-When you set up Libation, you'll specify a Books directory. Libation looks inside that directory and all subdirectories to look for files or folders with each library book's audible id. This way, organization is completely up to you. When you download + decrypt a book, you get several files
-
-* .m4b: your audiobook in m4b format. This is the most pure version of your audiobook and retains the highest quality. Now that it's decrypted, you can play it on any audio player and put it on any device. If you'd like, you can also use 3rd party tools to turn it into an mp3. The freedom to do what you want with your files was the original inspiration for Libation.
-* .cue: this is a file which logs where chapter breaks occur. Many tools are able to use this if you want to split your book into files along chapter lines.
-
-### Export your library
-
-![Export](images/Export.png)
-
-Export your library to Excel, CSV, or JSON
-
-### I still need help
-
-[You can open an issue here](https://github.com/rmcrackan/Libation/issues) for bug reports, feature requests, or specialized help.
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/getting-started.md))

Documentation/InstallOnLinux.md

@@ -1,67 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/installation/linux
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-## Packaging status
-
-[![Packaging status](https://repology.org/badge/vertical-allrepos/libation.svg)](https://repology.org/project/libation/versions)
-
-New Libation releases are automatically packed into `.deb` and `.rpm` package and are available from the [Libation repository's releases page](https://github.com/rmcrackan/Libation/releases).
-
-Run these commands in your terminal to download and install Libation. **Make sure you replace** `X.X.X` with the latest Libation version and `ARCH` with your CPU's architechture (either `amd64` or `arm64`).
-
-### Debian
-  ```Console
-  wget -O libation.deb https://github.com/rmcrackan/Libation/releases/download/vX.X.X/Libation.X.X.X-linux-chardonnay-ARCH.deb
-  sudo apt install ./libation.deb
-  ```
-### Redhat and CentOS
-  ```Console
-  wget -O libation.rpm https://github.com/rmcrackan/Libation/releases/download/vX.X.X/Libation.X.X.X-linux-chardonnay-ARCH.rpm
-  sudo yum install ./libation.rpm
-  ```
-### Fedora
-  ```Console
-  wget -O libation.rpm https://github.com/rmcrackan/Libation/releases/download/vX.X.X/Libation.X.X.X-linux-chardonnay-ARCH.rpm
-  sudo dnf5 install ./libation.rpm
-  ```
----
-### Arch Linux
-  ```Console
-  yay -S libation
-  ```
-  This package is available on [Arch User Repository](https://aur.archlinux.org/packages/libation), install via your choice of [AUR helpers](https://wiki.archlinux.org/title/AUR_helpers).
-  
-  Thanks to [mhdi](https://aur.archlinux.org/account/mhdi) for taking care of AUR package maintenance.
-### NixOS
-  - Install via `nix-shell`
-    ```Console
-    nix-shell -p libation
-    ```
-    A `nix-shell` will temporarily modify your $PATH environment variable. This can be used to try a piece of software before deciding to permanently install it.
-  - Install via NixOS configuration
-    ```Console
-    environment.systemPackages = [
-      pkgs.libation
-    ];
-    ```
-    Add the following Nix code to your NixOS Configuration, usually located in `/etc/nixos/configuration.nix`
-  - On NixOS via via `nix-env`
-    ```Console
-    nix-env -iA nixos.libation
-    ```
-  - On Non NixOS via `nix-env`
-    ```Console
-    nix-env -iA nixpkgs.libation
-    ```
-    Warning: Using `nix-env` permanently modifies a local profile of installed packages. This must be updated and maintained by the user in the same way as with a traditional package manager.
-
-    Thanks to [TomaSajt](https://github.com/tomasajt) for taking care of Nix package maintenance.
-
-If your desktop uses gtk, you should now see Libation among your applications.
-
-Additionally, you may launch Libation, LibationCli, and Hangover (the Libation recovery app) via the command line using 'libation, libationcli', and 'hangover' aliases respectively.
-
-Report bugs to https://github.com/rmcrackan/Libation/issues
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/installation/linux.md))

Documentation/InstallOnMac.md

@@ -1,82 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/installation/mac
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-
-# Run Libation on MacOS
-This walkthrough should get you up and running with Libation on your Mac.
-
-## Supports macOS 13 (Ventura) and above
-
-## Install Libation
-
-- Download the file from the latest release and extract it.
-  - Apple Silicon (M1, M2, ...): `Libation.x.x.x-macOS-chardonnay-`**arm64**`.tgz`
-  - Intel: `Libation.x.x.x-macOS-chardonnay-`**x64**`.tgz`
-- Move the extracted Libation app bundle to your applications folder.
-- Right-click on Libation and then click on open
-- The first time, it will not immediately show you an option to open it. Just dismiss the dialog and do the same thing again (right-click -> open) then you will get an option to run the unsigned application. This takes about 10 seconds.
-
-## If this doesn't work
-
-You can add Libation as a safe app without touching Gatekeeper.
-
-- Copy/paste/run the following command. Adjust the file path to the Libation.app on your computer if necessary.
-
-  ```Console
-  xattr -r -d com.apple.quarantine ~/Downloads/Libation.app
-  ```
-- Close the terminal and use Libation!
-
-## If this still doesn't work
-
-- Copy/paste/run the following command (you'll be prompted to enter your Mac password)
-
-  ```Console
-  sudo spctl --master-disable && sudo spctl --add --label "Libation" /Applications/Libation.app && open /Applications/Libation.app && sudo spctl --master-enable
-  ```
-
-* Close the terminal and use Libation!
-
-## "Apple can't check app for malicious software"
-
-From: [How to Open Anyway](https://support.apple.com/guide/mac-help/apple-cant-check-app-for-malicious-software-mchleab3a043/mac):
-
-* On your Mac, choose Apple menu > System Settings, then click Privacy & Security in the sidebar. (You may need to scroll down.)
-* Go to Security, then click Open.
-* Click Open Anyway. This button is available for about an hour after you try to open the app.
-* Enter your login password, then click OK.
-
-## Troubleshooting
-
-If Libation fails to start after completing the above steps, try the following:
-
-1. Right-click the Libation app in your applications folder and select _Show Package Contents_
-2. Open the `Contents` folder and then the `MacOS` folder.
-3. Find the file named `Libation`, right-click it, and then select _Open_.
-
-Libation _should_ launch, and you should now be able to open Libation by just double-clicking the app bundle in your applications folder.
-
-
-## Running Hangover
-
-Libation comes with a recovery app called Hangover. You can start it by running this command:
-```Console
-open /Applications/Libation.app --args hangover
-```
-
-## Running LibationCli
-
-Libation comes with a command-line interface. Unfortunately, due to the way apps are sandboxed on mac, its use is somewhat limited. To open a new sandboxed terminal in LibationCli's directory, run the following command:
-```Console
-open /Applications/Libation.app --args cli
-```
-To use LibationCli from an unsandboxed terminal, you must disable gatekeeper again and run the program directly at `/Applications/Libation.app/Contents/MacOS/LibationCli`
-
-Then use `./LibationCli` to execute a command.
-
-## Get Libation running on Mac
-
-[Run Libation on MacOS](https://user-images.githubusercontent.com/37587114/219271379-a922e4e1-48a0-48e4-bd81-48aa1226a4f5.mp4)
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/installation/mac.md))

Documentation/LinuxDevelopmentSetupUsingNix.md

@@ -1,64 +1,3 @@
-# Development Environment Setup using Nix or Nix Flakes on Linux x86_64
-[Nix flakes](https://nixos.wiki/wiki/Flakes) can be used to provide version controlled reproducible and cross-platform development environments. The key files are:
-- `flake.nix`: Defines the flake inputs and outputs, including development shells.
-- `shell.nix`: This file defines the dependencies and additionally adds support for the Impure `nix-shell` method. This is used by the flake to create the dev environment.
-- `flake.lock`: Locks the versions of inputs for reproducibility.
----
-## Prerequisites
-- [Nix](https://nixos.org/download.html) the package manager or NixOs installed on Linux (x86_64-linux)
-- Optional: flakes support enabled. 
----
-## Using the Development Shell
-You have two primary ways to enter the development shell with Nix:
-### 1. Using `nix develop` (flake-native command)
-This is the recommended way if you have Nix with flakes support. Flake guarantee the versions of the dependencies and can be controlled through `flake.nix` and `flake.lock`.
-```
-nix develop
-```
-This will open a shell with all dependencies and environment configured as per the `flake.nix` for (`x86_64-linux`) systems only at this time.
+# This page has been moved to https://getlibation.com/docs/development/nix-linux-setup
 
----
-### 2. Using `nix-shell` (that's why shell.nix is a separate file)
-If you want to use traditional `nix-shell` tooling which uses the nixpkgs version of your system:
-```
-nix-shell
-```
-This will drop you into the shell environment defined in `shell.nix`. Note that this is not flake-native method and does not use the locked nixpkgs in `flake.lock` so exact versions of the dependancies is not guaranteed.
-
----
-## What’s inside the dev shell?
-- The environment variables and packages configured in `shell.nix` will be available.
-- The package set (`pkgs`) used aligns with the versions locked in `flake.lock` to ensure reproducibility.
-
----
-## Example Workflow using flakes
-```
-# Navigate to the project root folder which contains the flake.nix, flake.lock and shell.nix files.
-cd /home/user/dev/Libation
-# Enter the flake development shell (Linux x86_64)
-nix develop
-# run VSCode or VSCodium from the current shell environment
-code .
-# Run or Debug using VSCode and VSCodium using the linux Launch configuration.
-```
-![Debug using VSCode and VSCodium](./images/StartingDebuggingInVSCode.png)
-
-You can also Build and run your application inside the shell.
-``` 
-dotnet build ./Source/LibationAvalonia/LibationAvalonia.csproj -p:TargetFrameworks=net9.0 -p:TargetFramework=net9.0 -p:RuntimeIdentifier=linux-x64
-```
-
----
-
-## Notes
-- Leaving the current shell environemnt will drop all added dependancies and you will not be able to run or debug the program unless your system has those dependancies defined globally.
-- To exit the shell environment voluntarily use `exit` inside the shell.
-- Ensure you have no conflicting `nix.conf` or `global.json` that might affect SDK versions or runtime identifiers.
-- Keep your `flake.lock` file committed to ensure builds are reproducible for all collaborators.
-
----
-## References
-
-- [Nix Flakes - NixOS Wiki](https://nixos.wiki/wiki/Flakes)
-- [Nix.dev - Introduction to Nix flakes](https://nix.dev/manual/nix/2.28/command-ref/new-cli/nix3-flake-init)
-- [Nix-shell Manual](https://nixos.org/manual/nix/stable/command-ref/nix-shell.html)
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/development/nix-linux-setup.md))

Documentation/NamingTemplates.md

@@ -1,178 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
-
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-
-# Naming Templates
-File and Folder names can be customized using Libation's built-in tag template naming engine. To edit how folder and file names are created, go to Settings \> Download/Decrypt and edit the naming templates. If you're splitting your audiobook into multiple files by chapter, you can also use a custom template to set each chapter's title metadata tag by editing the template in Settings \> Audio File Options.
-
-These templates apply to both GUI and CLI.
-
-# Table of Contents
-
-- [Template Tags](#template-tags)
-  - [Property Tags](#property-tags)
-  - [Conditional Tags](#conditional-tags)
-- [Tag Formatters](#tag-formatters)
-  - [Text Formatters](#text-formatters)
-  - [Series Formatters](#series-formatters)
-  - [Series List Formatters](#series-list-formatters)
-  - [Name Formatters](#name-formatters)
-  - [Name List Formatters](#name-list-formatters)
-  - [Number Formatters](#number-formatters)
-  - [Date Formatters](#date-formatters)
-
-
-# Template Tags
-
-These are the naming template tags currently supported by Libation.
-
-## Property Tags
-These tags will be replaced in the template with the audiobook's values.
-
-|Tag|Description|Type|
-|-|-|-|
-|\<id\> **†**|Audible book ID (ASIN)|Text|
-|\<title\>|Full title with subtitle|[Text](#text-formatters)|
-|\<title short\>|Title. Stop at first colon|[Text](#text-formatters)|
-|\<audible title\>|Audible's title (does not include subtitle)|[Text](#text-formatters)|
-|\<audible subtitle\>|Audible's subtitle|[Text](#text-formatters)|
-|\<author\>|Author(s)|[Name List](#name-list-formatters)|
-|\<first author\>|First author|[Name](#name-formatters)|
-|\<narrator\>|Narrator(s)|[Name List](#name-list-formatters)|
-|\<first narrator\>|First narrator|[Name](#name-formatters)|
-|\<series\>|All series to which the book belongs (if any)|[Series List](#series-list-formatters)|
-|\<first series\>|First series|[Series](#series-formatters)|
-|\<series#\>|Number order in series (alias for \<first series[{#}]\>|[Number](#number-formatters)|
-|\<bitrate\>|Bitrate (kbps) of the last downloaded audiobook|[Number](#number-formatters)|
-|\<samplerate\>|Sample rate (Hz) of the last downloaded audiobook|[Number](#number-formatters)|
-|\<channels\>|Number of audio channels in the last downloaded audiobook|[Number](#number-formatters)|
-|\<codec\>|Audio codec of the last downloaded audiobook|[Text](#text-formatters)|
-|\<file version\>|Audible's file version number of the last downloaded audiobook|[Text](#text-formatters)|
-|\<libation version\>|Libation version used during last download of the audiobook|[Text](#text-formatters)|
-|\<account\>|Audible account of this book|[Text](#text-formatters)|
-|\<account nickname\>|Audible account nickname of this book|[Text](#text-formatters)|
-|\<locale\>|Region/country|[Text](#text-formatters)|
-|\<year\>|Year published|[Number](#number-formatters)|
-|\<language\>|Book's language|[Text](#text-formatters)|
-|\<language short\> **†**|Book's language abbreviated. Eg: ENG|Text|
-|\<file date\>|File creation date/time.|[DateTime](#date-formatters)|
-|\<pub date\>|Audiobook publication date|[DateTime](#date-formatters)|
-|\<date added\>|Date the book added to your Audible account|[DateTime](#date-formatters)|
-|\<ch count\> **‡**|Number of chapters|[Number](#number-formatters)|
-|\<ch title\> **‡**|Chapter title|[Text](#text-formatters)|
-|\<ch#\> **‡**|Chapter number|[Number](#number-formatters)|
-|\<ch# 0\> **‡**|Chapter number with leading zeros|[Number](#number-formatters)|
-
-**†** Does not support custom formatting
-
-**‡** Only valid for Chapter Filename and Chapter Tile Metadata
-
-To change how these properties are displayed, [read about custom formatters](#tag-formatters)
-
-## Conditional Tags
-Anything between the opening tag (`<tagname->`) and closing tag (`<-tagname>`) will only appear in the name if the condition evaluates to true. 
-
-|Tag|Description|Type|
-|-|-|-|
-|\<if series-\>...\<-if series\>|Only include if part of a book series or podcast|Conditional|
-|\<if podcast-\>...\<-if podcast\>|Only include if part of a podcast|Conditional|
-|\<if bookseries-\>...\<-if bookseries\>|Only include if part of a book series|Conditional|
-|\<if podcastparent-\>...\<-if podcastparent\>**†**|Only include if item is a podcast series parent|Conditional|
-|\<has PROPERTY-\>...\<-has\>|Only include if the PROPERTY has a value (i.e. not null or empty)|Conditional|
-
-**†** Only affects the podcast series folder naming if "Save all podcast episodes to the series parent folder" option is checked.
-
-For example, `<if podcast-><series><-if podcast>` will evaluate to the podcast's series name if the file is a podcast. For audiobooks that are not podcasts, that tag will be blank.
-
-You can invert the condition (instead of displaying the text when the condition is true, display the text when it is false) by playing a `!` symbol before the opening tag name. 
-
-|Inverted Tag|Description|Type|
-|-|-|-|
-|\<!if series-\>...\<-if series\>|Only include if *not* part of a book series or podcast|Conditional|
-|\<!if podcast-\>...\<-if podcast\>|Only include if *not* part of a podcast|Conditional|
-|\<!if bookseries-\>...\<-if bookseries\>|Only include if *not* part of a book series|Conditional|
-|\<!if podcastparent-\>...\<-if podcastparent\>**†**|Only include if item is *not* a podcast series parent|Conditional|
-|\<!has PROPERTY-\>...\<-has\>|Only include if the PROPERTY *does not* have a value (i.e. is null or empty)|Conditional|
-
-**†** Only affects the podcast series folder naming if "Save all podcast episodes to the series parent folder" option is checked.
-
-As an example, this folder template will place all Liberated podcasts into a "Podcasts" folder and all liberated books (not podcasts) into a "Books" folder.
-
-`<if podcast->Podcasts<-if podcast><!if podcast->Books<-if podcast>\<title>`
-
-This example will add a number if the `<series#\>` tag has a value:
-
-`<has series#><series#><-has>`
-
-This example will put non-series books in a "Standalones" folder:
-
-`<!if series->Standalones/<-if series>`
-
-And this example will customize the title based on whether the book has a subtitle:
-
-`<audible title><has audible subtitle->-<audible subtitle><-has>`
-
-# Tag Formatters
-**Text**, **Name List**, **Number**, and **DateTime** tags can be optionally formatted using format text in square brackets after the tag name. Below is a list of supported formatters for each tag type.
-
-## Text Formatters
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|L|Converts text to lowercase|\<title[L]\>|a study in scarlet꞉ a sherlock holmes novel|
-|U|Converts text to uppercase|\<title short[U]\>|A STUDY IN SCARLET|
-
-## Series Formatters
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|\{N \| # \| ID\}|Formats the series using<br>the series part tags.<br>\{N\} = Series Name<br>\{#\} = Number order in series<br>\{#:[Number_Formatter](#number-formatters)\} = Number order in series, formatted<br>\{ID\} = Audible Series ID<br><br>Default is \{N\}|`<first series>`<hr>`<first series[{N}]>`<hr>`<first series[{N}, {#}, {ID}]>`<hr>`<first series[{N}, {ID}, {#:00.0}]>`|Sherlock Holmes<hr>Sherlock Holmes<hr>Sherlock Holmes, 1-6, B08376S3R2<hr>Sherlock Holmes, B08376S3R2, 01.0-06.0|
-
-## Series List Formatters
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|separator()|Speficy the text used to join<br>multiple series names.<br><br>Default is ", "|`<series[separator(; )]>`|Sherlock Holmes; Some Other Series|
-|format(\{N \| # \| ID\})|Formats the series properties<br>using the name series tags.<br>See [Series Formatter Usage](#series-formatters) above.|`<series[format({N}, {#})`<br>`separator(; )]>`<hr>`<series[format({ID}-{N}, {#:00.0})]>`|Sherlock Holmes, 1-6; Book Collection, 1<hr>B08376S3R2-Sherlock Holmes, 01.0-06.0, B000000000-Book Collection, 01.0|
-|max(#)|Only use the first # of series<br><br>Default is all series|`<series[max(1)]>`|Sherlock Holmes|
-
-## Name Formatters
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|\{T \| F \| M \| L \| S \| ID\}|Formats the human name using<br>the name part tags.<br>\{T\} = Title (e.g. "Dr.")<br>\{F\} = First name<br>\{M\} = Middle name<br>\{L\} = Last Name<br>\{S\} = Suffix (e.g. "PhD")<br>\{ID\} = Audible Contributor ID<br><br>Default is \{P\} \{F\} \{M\} \{L\} \{S\}|`<first narrator[{L}, {F}]>`<hr>`<first author[{L}, {F} _{ID}_]>`|Fry, Stephen<hr>Doyle, Arthur \_B000AQ43GQ\_;<br>Fry, Stephen \_B000APAGVS\_|
-
-## Name List Formatters
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|separator()|Speficy the text used to join<br>multiple people's names.<br><br>Default is ", "|`<author[separator(; )]>`|Arthur Conan Doyle; Stephen Fry|
-|format(\{T \| F \| M \| L \| S \| ID\})|Formats the human name using<br>the name part tags.<br>See [Name Formatter Usage](#name-formatters) above.|`<author[format({L}, {F})`<br>`separator(; )]>`<hr>`<author[format({L}, {F}`<br>`_{ID}_) separator(; )]>`|Doyle, Arthur; Fry, Stephen<hr>Doyle, Arthur \_B000AQ43GQ\_;<br>Fry, Stephen \_B000APAGVS\_|
-|sort(F \| M \| L)|Sorts the names by first, middle,<br>or last name<br><br>Default is unsorted|`<author[sort(M)]>`|Stephen Fry, Arthur Conan Doyle|
-|max(#)|Only use the first # of names<br><br>Default is all names|`<author[max(1)]>`|Arthur Conan Doyle|
-
-## Number Formatters
-For more custom formatters and examples, [see this guide from Microsoft](https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-numeric-format-strings).
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|\[integer\]|Zero-pads the number|\<bitrate\[4\]\><br>\<series#\[3\]\><br>\<samplerate\[6\]\>|0128<br>001<br>044100|
-|0|Replaces the zero with the corresponding digit if one<br>is present; otherwise, zero appears in the result string.|\<series#\[000.0\]\>|001.0|
-|#|Replaces the "#" symbol with the corresponding digit if one<br> is present; otherwise, no digit appears in the result string|\<series#\[00.##\]\>|01|
-
-## Date Formatters
-Form more standard formatters, [see this guide from Microsoft](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings).
-### Standard DateTime Formatters
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|s|Sortable date/time pattern.|\<file date[s]\>|2023-02-14T13:45:30|
-|Y|Year month pattern.|\<file date[Y]\>|February 2023|
-
-### Custom DateTime Formatters
-You can use custom formatters to construct customized DateTime string. For more custom formatters and examples, [see this guide from Microsoft](https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings).
-|Formatter|Description|Example Usage|Example Result|
-|-|-|-|-|
-|yyyy|4-digit year|\<file date[yyyy]\>|2023|
-|yy|2-digit year|\<file date[yy]\>|23|
-|MM|2-digit month|\<file date[MM]\>|02|
-|dd|2-digit day of the month|\<file date[yyyy-MM-dd]\>|2023-02-14|
-|HH<br>mm|The hour, using a 24-hour clock from 00 to 23<br>The minute, from 00 through 59.|\<file date[HH:mm]\>|14:45|
-
+# This page has been moved to https://getlibation.com/docs/features/naming-templates
 
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/features/naming-templates.md))

Documentation/SearchingAndFiltering.md

@@ -1,79 +1,3 @@
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+# This page has been moved to https://getlibation.com/docs/features/searching-and-filtering
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
-
-
-
-# Searching and filtering: Table of Contents
-
-- [Tags](#tags)
-- [Searches](#searches)
-- [Search examples](#search-examples)
-- [Filters](#filters)
-
-
-
-### Tags
-
-To add tags to a title, click the tags button
-
-![Tags step 1](images/Tags1.png)
-
-Add as many tags as you'd like. Tags are separated by a space. Each tag can contain letters, numbers, and underscores
-
-![Tags step 2](images/Tags2.png)
-
-Tags are saved non-case specific for easy search. There is one special tag "hidden" which will also grey-out the book
-
-![Tags step 3](images/Tags3.png)
-
-To edit tags, just click the button again.
-
-### Searches
-
-Libation's advanced searching is built on the powerful Lucene search engine. Simple searches are effortless and powerful searches are simple. To search, just type and click Filter or press enter
-
-* Type anything in the search box to search common fields: title, authors, narrators, and the book's audible id
-* Use Lucene's "Query Parser Syntax" for advanced searching.
-    * Easy tutorial: http://www.lucenetutorial.com/lucene-query-syntax.html
-    * Full official guide: https://lucene.apache.org/core/2_9_4/queryparsersyntax.html
-* Tons of search fields, specific to audiobooks
-* Synonyms so you don't have to memorize magic words. Eg: author and author**s** will both work
-* Click [?] button for a full list of search fields and synonyms ![Filter options](images/FilterOptionsButton.png)
-* Search by tag like \[this\]
-* When tags have an underscore you can use part of the tag. This is useful for quick categories. The below examples make this more clear.
-
-### Search examples
-
-Search for anything with the word potter
-
-![Search example: potter](images/SearchExamplePotter.png)
-
-If you only want to see Harry Potter
-
-![Search example: "harry potter"](images/SearchExampleHarryPotter.png)
-
-If you only want to see potter except for Harry Potter. You can also use "-" instead of "NOT"
-
-![Search example: "potter NOT harry"](images/SearchExamplePotterNotHarry.png)
-![Search example: "potter -harry"](images/SearchExamplePotterNotHarry2.png)
-
-To see only books written by Neil Gaiman where he also narrates his own book. (If you don't include AND, you'll see everything written by Neil Gaiman and also all books in your library which are self-narrated.)
-
-![Search example: author:gaiman AND authornarrated](images/SearchExampleGaimanAuthorNarrated.png)
-
-I tagged autobiographies as auto_bio and biographies written by someone else as bio. I can get only autobiographies with \[auto_bio\] or get both by searching \[bio\]
-
-![Search example: \[bio\]](images/SearchExampleBio.png)
-![Search example: \[auto_bio\]](images/SearchExampleAutoBio.png)
-
-### Filters
-
-If you have a search you want to save, click Add To Quick Filters to save it in your Quick Filters list. To use it again, select it from the Quick Filters list.
-
-To edit this list go to Quick Filters > Edit quick filters. Here you can re-order the list, delete filters, double-click a filter to edit it, or double-click the bottom blank box to add a new filter.
-
-Check "Quick Filters > Start Libation with 1st filter Default" to have your top filter automatically applied when Libation starts. In this top example, I want to always start without these: at books I've tagged hidden, books I've tagged as free_audible_originals, and books which I have rated.
-
-![default filters](images/FiltersDefault.png)
+([page in github](https://github.com/rmcrackan/Libation/blob/master/docs/features/searching-and-filtering.md))

README.md

@@ -1,75 +1,57 @@
 # Libation: Liberate your Library
 
-## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
+**Libation** is a free, open-source application for downloading and managing your Audible audiobooks. It decrypts your library, removes DRM, and lets you own your audiobooks forever.
 
-### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us)
-...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
+> <a href="https://getlibation.com"><img src=".github/download-icon.svg" width="20" height="20" alt="" /></a> **[Which version should I download?](https://getlibation.com)** — get a recommended download for your system on our site.
 
+## Features
 
+- **Unlock Your Library**: Download and remove DRM from your audiobooks.
+- **Cross-Platform**: Fully supported on Windows, macOS, and Linux.
+- **Region Support**: Works with Audible regions US, UK, Canada, Germany, France, Australia, Japan, India, and Spain.
+- **Advanced Organization**: Search, filter, and tag your books.
+- **Fast & Efficient**: Powered by AAXClean for fast decryption without heavy dependencies like ffmpeg.
+- **Import**: Easily import your existing library, including cover art.
 
-# Table of Contents
+## Getting started with Libation
 
-- [Audible audiobook manager](#audible-audiobook-manager)
-    - [The good](#the-good)
-    - [The bad](#the-bad)
-    - [The ugly](#the-ugly)
-- [Getting started](Documentation/GettingStarted.md)
-    - [Download Libation](Documentation/GettingStarted.md#download-libation-1)
-    - [Installation](Documentation/GettingStarted.md#installation)
-    - [Create Accounts](Documentation/GettingStarted.md#create-accounts)
-    - [Import your library](Documentation/GettingStarted.md#import-your-library)
-    - [Download your books -- DRM-free!](Documentation/GettingStarted.md#download-your-books----drm-free)
-    - [Download PDF attachments](Documentation/GettingStarted.md#download-pdf-attachments)
-    - [Details of downloaded files](Documentation/GettingStarted.md#details-of-downloaded-files)
-    - [Export your library](Documentation/GettingStarted.md#export-your-library)
-    - If you still need help, [you can open an issue here](https://github.com/rmcrackan/Libation/issues) for bug reports, feature requests, or specialized help.
-- [Searching and filtering](Documentation/SearchingAndFiltering.md)
-    - [Tags](Documentation/SearchingAndFiltering.md#tags)
-    - [Searches](Documentation/SearchingAndFiltering.md#searches)
-    - [Search examples](Documentation/SearchingAndFiltering.md#search-examples)
-    - [Filters](Documentation/SearchingAndFiltering.md#filters)
-- [Advanced](Documentation/Advanced.md)
-    - [Files and folders](Documentation/Advanced.md#files-and-folders)
-    - [Settings](Documentation/Advanced.md#settings)
-    - [Custom File Naming](Documentation/NamingTemplates.md)
-    - [Command Line Interface](Documentation/Advanced.md#command-line-interface)
-    - [Custom Theme Colors](Documentation/Advanced.md#custom-theme-colors) (Chardonnay Only)
-    - [Audio Formats (Dolby Atmos, Widevine, Spacial Audio)](Documentation/AudioFileFormats.md)
-- [Docker](Documentation/Docker.md)
-- [Frequently Asked Questions](Documentation/FrequentlyAskedQuestions.md)
-
-## Getting started
+All documentation has been moved to our new site: [getlibation.com](https://getlibation.com). Or jump to the important bits:
 
+* [Getting Started](https://getlibation.com/docs/getting-started)
 * [Download](https://github.com/rmcrackan/Libation/releases/latest)
-* [Step-by-step walk-through](Documentation/GettingStarted.md)
+* [Issues, bugs, and requests](https://github.com/rmcrackan/Libation/issues)
+* [Documentation](https://getlibation.com/docs/index)
 
-## Audible audiobook manager
+## Development
 
-### The good
+Grab the latest release for your platform from the [Releases Page](https://github.com/rmcrackan/Libation/releases/latest).
 
-* Import library from audible, including cover art
-* Download and remove DRM from all books
-* Download accompanying PDFs
-* Add tags to books for better organization
-* Powerful advanced search built on the Lucene search engine
-* Customizable saved filters for common searches
-* Open source
-* Supports most regions: US, UK, Canada, Germany, France, Australia, Japan, India, and Spain
-* Fully supported in Windows, Mac, and Linux
+## Documentation
 
-<a name="theBad"/>
+Comprehensive documentation is available in the `docs` directory and on our [Documentation Site](https://getlibation.com/docs).
 
-### The bad
+- [Getting Started](https://getlibation.com/docs/getting-started)
+- [FAQ](https://getlibation.com/docs/frequently-asked-questions)
 
-* Large file size
-* Made by a programmer, not a designer so the goals are function rather than beauty. And it shows
+## Development & Contributing
 
-### The ugly
+We welcome contributions!
 
-* Documentation? Yer lookin' at it
-* This is a single-developer personal passion project. Support, response, updates, enhancements, bug fixes etc are as my free time allows
-* I have a full-time job, a life, and a finite attention span. Therefore a lot of time can potentially go by with no improvements of any kind
+- **[Development Getting Started](https://getlibation.com/docs/development/getting-started)**: Setup your environment.
+- **[Contribute](https://getlibation.com/docs/development/contribute)**: How to contribute code.
+- **[Website & Docs](https://getlibation.com/docs/development/website)**: How to run and improve the documentation.
+- **[Linux Setup (Nix)](https://getlibation.com/docs/development/nix-linux-setup)**: Nix-based environment setup.
 
-Disclaimer: I've made every good-faith effort to include nothing insecure, malicious, anti-privacy, or destructive. That said: use at your own risk.
+## Community & Support
 
-I made this for myself and I want to share it with the great programming and audible/audiobook communities which have been so generous with their time and help.
+- **[Issues](https://github.com/rmcrackan/Libation/issues)**: Report bugs or request features.
+- **[PayPal](https://paypal.me/mcrackan?locale.x=en_us)**: Support the project if you find it useful.
+
+## License
+
+Libation is released under the GPL-3.0 License
+
+---
+
+If you found this useful, tell a friend. If you found this REALLY useful, you can click here to PayPal.me
+...or just tell more friends. As long as I'm maintaining this software, it will remain free and open source.

Scripts/Bundle_MacOS.sh

@@ -58,9 +58,9 @@ mkdir -p $BUNDLE_MACOS
 
 mv "${BIN_DIR}/"*  $BUNDLE_MACOS
 
-if [ $? -ne 0 ]
- then echo "Error moving ${BIN_DIR} files"
- exit
+if [ $? -ne 0 ]; then
+  echo "Error moving ${BIN_DIR} files"
+  exit 1
 fi
 
 echo "Make fileicon executable..."
@@ -83,10 +83,11 @@ mv $BUNDLE_MACOS/Libation.entitlements ./Libation.entitlements
 
 PLIST_ARCH=$(echo $ARCH | sed 's/x64/x86_64/')
 echo "Set LSArchitecturePriority to $PLIST_ARCH"
-sed -i -e "s/ARCHITECTURE_STRING/$PLIST_ARCH/" $BUNDLE_CONTENTS/Info.plist
+# Portable sed -i (BSD sed on macOS requires backup arg; use .bak then remove)
+sed -i.bak "s/ARCHITECTURE_STRING/$PLIST_ARCH/" $BUNDLE_CONTENTS/Info.plist && rm -f $BUNDLE_CONTENTS/Info.plist.bak
 
 echo "Set CFBundleVersion to $VERSION"
-sed -i -e "s/VERSION_STRING/$VERSION/" $BUNDLE_CONTENTS/Info.plist
+sed -i.bak "s/VERSION_STRING/$VERSION/" $BUNDLE_CONTENTS/Info.plist && rm -f $BUNDLE_CONTENTS/Info.plist.bak
 
 delfiles=('MacOSConfigApp' 'MacOSConfigApp.deps.json' 'MacOSConfigApp.runtimeconfig.json')
 for n in "${delfiles[@]}"
@@ -117,6 +118,7 @@ mkdir Libation/.background
 mv background.png Libation/.background/
 ln -s /Applications "./Libation/ "
 mkdir ./bundle
+sync
 hdiutil create -srcFolder ./Libation -o "./bundle/$DMG_FILE"
 # Create a .DS_Store by:
 #  - mounting an existing image in shadow mode (hdiutil attach Libation.dmg -shadow junk.dmg)

Source/AaxDecrypter/AaxDecrypter.csproj

@@ -2,6 +2,7 @@
 
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
   </PropertyGroup>
 
 	<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
@@ -13,7 +14,7 @@
 	</PropertyGroup>
 
 	<ItemGroup>
-	  <PackageReference Include="AAXClean.Codecs" Version="2.1.0.1" />
+	  <PackageReference Include="AAXClean.Codecs" Version="3.0.2" />
 	</ItemGroup>
 
 	<ItemGroup>

Source/AaxDecrypter/AaxcDownloadConvertBase.cs

@@ -1,144 +1,150 @@
 using AAXClean;
+using Mpeg4Lib;
 using System;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 
-#nullable enable
-namespace AaxDecrypter
-{	
-	public abstract class AaxcDownloadConvertBase : AudiobookDownloadBase
+namespace AaxDecrypter;
+
+public abstract class AaxcDownloadConvertBase : AudiobookDownloadBase
+{
+	public event EventHandler<MetadataItems>? RetrievedMetadata;
+
+	public Mp4File? AaxFile { get; private set; }
+	protected Mp4Operation? AaxConversion { get; set; }
+
+	protected AaxcDownloadConvertBase(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
+		: base(outDirectory, cacheDirectory, dlOptions) { }
+
+	/// <summary>Setting cover art by this method will insert the art into the audiobook metadata</summary>
+	public override void SetCoverArt(byte[] coverArt)
 	{
-		public event EventHandler<AppleTags>? RetrievedMetadata;
-
-		public Mp4File? AaxFile { get; private set; }
-		protected Mp4Operation? AaxConversion { get; set; }
-
-		protected AaxcDownloadConvertBase(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
-			: base(outDirectory, cacheDirectory, dlOptions) { }
-
-		/// <summary>Setting cover art by this method will insert the art into the audiobook metadata</summary>
-		public override void SetCoverArt(byte[] coverArt)
-		{
-			base.SetCoverArt(coverArt);
-			if (coverArt is not null && AaxFile?.AppleTags is not null)
-				AaxFile.AppleTags.Cover = coverArt;
-		}
-
-		public override async Task CancelAsync()
-		{
-			await base.CancelAsync();
-			await (AaxConversion?.CancelAsync() ?? Task.CompletedTask);
-		}
-
-		private Mp4File Open()
-		{
-			if (DownloadOptions.DecryptionKeys is not KeyData[] keys || keys.Length == 0)
-				throw new InvalidOperationException($"{nameof(DownloadOptions.DecryptionKeys)} cannot be null or empty for a '{DownloadOptions.InputType}' file.");
-			else if (DownloadOptions.InputType is FileType.Dash)
-			{
-				//We may have multiple keys , so use the key whose key ID matches
-				//the dash files default Key ID.
-				var keyIds = keys.Select(k => new Guid(k.KeyPart1, bigEndian: true)).ToArray();
-
-				var dash = new DashFile(InputFileStream);
-				var kidIndex = Array.IndexOf(keyIds, dash.Tenc.DefaultKID);
-
-				if (kidIndex == -1)
-					throw new InvalidOperationException($"None of the {keyIds.Length} key IDs match the dash file's default KeyID of {dash.Tenc.DefaultKID}");
-
-				keys[0] = keys[kidIndex];
-				var keyId = keys[kidIndex].KeyPart1;
-				var key = keys[kidIndex].KeyPart2 ?? throw new InvalidOperationException($"{nameof(DownloadOptions.DecryptionKeys)} for '{DownloadOptions.InputType}' must have a non-null decryption key (KeyPart2).");
-				dash.SetDecryptionKey(keyId, key);
-				WriteKeyFile($"KeyId={Convert.ToHexString(keyId)}{Environment.NewLine}Key={Convert.ToHexString(key)}");
-				return dash;
-			}
-			else if (DownloadOptions.InputType is FileType.Aax)
-			{
-				var aax = new AaxFile(InputFileStream);
-				var key = keys[0].KeyPart1;
-				aax.SetDecryptionKey(keys[0].KeyPart1);
-				WriteKeyFile($"ActivationBytes={Convert.ToHexString(key)}");
-				return aax;
-			}
-			else if (DownloadOptions.InputType is FileType.Aaxc)
-			{
-				var aax = new AaxFile(InputFileStream);
-				var key = keys[0].KeyPart1;
-				var iv = keys[0].KeyPart2 ?? throw new InvalidOperationException($"{nameof(DownloadOptions.DecryptionKeys)} for '{DownloadOptions.InputType}' must have a non-null initialization vector (KeyPart2).");
-				aax.SetDecryptionKey(keys[0].KeyPart1, iv);
-				WriteKeyFile($"Key={Convert.ToHexString(key)}{Environment.NewLine}IV={Convert.ToHexString(iv)}");
-				return aax;
-			}
-			else throw new InvalidOperationException($"{nameof(DownloadOptions.InputType)} of '{DownloadOptions.InputType}' is unknown.");
-
-			void WriteKeyFile(string contents)
-			{
-				var keyFile = Path.Combine(Path.ChangeExtension(InputFileStream.SaveFilePath, ".key"));
-				File.WriteAllText(keyFile, contents + Environment.NewLine);
-				OnTempFileCreated(new(keyFile));
-			}
-		}
-
-		protected bool Step_GetMetadata()
-		{
-			AaxFile = Open();
-
-			RetrievedMetadata?.Invoke(this, AaxFile.AppleTags);
-
-			if (DownloadOptions.StripUnabridged)
-			{
-				AaxFile.AppleTags.Title = AaxFile.AppleTags.TitleSansUnabridged;
-				AaxFile.AppleTags.Album = AaxFile.AppleTags.Album?.Replace(" (Unabridged)", "");
-			}
-
-			if (DownloadOptions.FixupFile)
-			{
-				if (!string.IsNullOrWhiteSpace(AaxFile.AppleTags.Narrator))
-					AaxFile.AppleTags.AppleListBox.EditOrAddTag("©wrt", AaxFile.AppleTags.Narrator);
-
-				if (!string.IsNullOrWhiteSpace(AaxFile.AppleTags.Copyright))
-					AaxFile.AppleTags.Copyright = AaxFile.AppleTags.Copyright.Replace("(P)", "℗").Replace("&#169;", "©");
-
-				//Add audiobook shelf tags
-				//https://github.com/advplyr/audiobookshelf/issues/1794#issuecomment-1565050213
-				const string tagDomain = "com.pilabor.tone";
-
-				AaxFile.AppleTags.Title = DownloadOptions.Title;
-
-				if (DownloadOptions.Subtitle is string subtitle)
-					AaxFile.AppleTags.AppleListBox.EditOrAddFreeformTag(tagDomain, "SUBTITLE", subtitle);
-
-				if (DownloadOptions.Publisher is string publisher)
-					AaxFile.AppleTags.AppleListBox.EditOrAddFreeformTag(tagDomain, "PUBLISHER", publisher);
-
-				if (DownloadOptions.Language is string language)
-					AaxFile.AppleTags.AppleListBox.EditOrAddFreeformTag(tagDomain, "LANGUAGE", language);
-
-				if (DownloadOptions.AudibleProductId is string asin)
-				{
-					AaxFile.AppleTags.Asin = asin;
-					AaxFile.AppleTags.AppleListBox.EditOrAddTag("asin", asin);
-					AaxFile.AppleTags.AppleListBox.EditOrAddFreeformTag(tagDomain, "AUDIBLE_ASIN", asin);
-				}
-
-				if (DownloadOptions.SeriesName is string series)
-					AaxFile.AppleTags.AppleListBox.EditOrAddFreeformTag(tagDomain, "SERIES", series);
-
-				if (DownloadOptions.SeriesNumber is string part)
-					AaxFile.AppleTags.AppleListBox.EditOrAddFreeformTag(tagDomain, "PART", part);
-			}
-
-			OnRetrievedTitle(AaxFile.AppleTags.TitleSansUnabridged);
-			OnRetrievedAuthors(AaxFile.AppleTags.FirstAuthor);
-			OnRetrievedNarrators(AaxFile.AppleTags.Narrator);
-			OnRetrievedCoverArt(AaxFile.AppleTags.Cover);
-			OnInitialized();
-
-			return !IsCanceled;
-		}
-
-		protected virtual void OnInitialized() { }
+		base.SetCoverArt(coverArt);
+		if (coverArt is not null && AaxFile?.MetadataItems is not null)
+			AaxFile.MetadataItems.Cover = coverArt;
 	}
+
+	public override async Task CancelAsync()
+	{
+		await base.CancelAsync();
+		await (AaxConversion?.CancelAsync() ?? Task.CompletedTask);
+	}
+
+	private Mp4File Open()
+	{
+		if (DownloadOptions.DecryptionKeys is not KeyData[] keys || keys.Length == 0)
+			throw new InvalidOperationException($"{nameof(DownloadOptions.DecryptionKeys)} cannot be null or empty for a '{DownloadOptions.InputType}' file.");
+		else if (DownloadOptions.InputType is FileType.Dash)
+		{
+			//We may have multiple keys , so use the key whose key ID matches
+			//the dash files default Key ID.
+			var keyIds = keys.Select(k => new Guid(k.KeyPart1, bigEndian: true)).ToArray();
+
+			var dash = new DashFile(InputFileStream);
+			if (dash.Tenc is null)
+				throw new InvalidOperationException("The DASH file does not contain 'tenc' box, indicating that it is unencrypted.");
+
+			var kidIndex = Array.IndexOf(keyIds, dash.Tenc.DefaultKID);
+			if (kidIndex == -1)
+				throw new InvalidOperationException($"None of the {keyIds.Length} key IDs match the dash file's default KeyID of {dash.Tenc.DefaultKID}");
+
+			keys[0] = keys[kidIndex];
+			var keyId = keys[kidIndex].KeyPart1;
+			var key = keys[kidIndex].KeyPart2 ?? throw new InvalidOperationException($"{nameof(DownloadOptions.DecryptionKeys)} for '{DownloadOptions.InputType}' must have a non-null decryption key (KeyPart2).");
+			dash.SetDecryptionKey(keyId, key);
+			WriteKeyFile($"KeyId={Convert.ToHexString(keyId)}{Environment.NewLine}Key={Convert.ToHexString(key)}");
+
+			//Remove meta box containing DRM info
+			if (DownloadOptions.FixupFile && dash.Moov.GetChild<Mpeg4Lib.Boxes.MetaBox>() is { } meta)
+				dash.Moov.Children.Remove(meta);
+
+			return dash;
+		}
+		else if (DownloadOptions.InputType is FileType.Aax)
+		{
+			var aax = new AaxFile(InputFileStream);
+			var key = keys[0].KeyPart1;
+			aax.SetDecryptionKey(keys[0].KeyPart1);
+			WriteKeyFile($"ActivationBytes={Convert.ToHexString(key)}");
+			return aax;
+		}
+		else if (DownloadOptions.InputType is FileType.Aaxc)
+		{
+			var aax = new AaxFile(InputFileStream);
+			var key = keys[0].KeyPart1;
+			var iv = keys[0].KeyPart2 ?? throw new InvalidOperationException($"{nameof(DownloadOptions.DecryptionKeys)} for '{DownloadOptions.InputType}' must have a non-null initialization vector (KeyPart2).");
+			aax.SetDecryptionKey(keys[0].KeyPart1, iv);
+			WriteKeyFile($"Key={Convert.ToHexString(key)}{Environment.NewLine}IV={Convert.ToHexString(iv)}");
+			return aax;
+		}
+		else throw new InvalidOperationException($"{nameof(DownloadOptions.InputType)} of '{DownloadOptions.InputType}' is unknown.");
+
+		void WriteKeyFile(string contents)
+		{
+			var keyFile = Path.Combine(Path.ChangeExtension(InputFileStream.SaveFilePath, ".key"));
+			File.WriteAllText(keyFile, contents + Environment.NewLine);
+			OnTempFileCreated(new(keyFile));
+		}
+	}
+
+	protected bool Step_GetMetadata()
+	{
+		AaxFile = Open();
+
+		RetrievedMetadata?.Invoke(this, AaxFile.MetadataItems);
+
+		if (DownloadOptions.StripUnabridged)
+		{
+			AaxFile.MetadataItems.Title = AaxFile.MetadataItems.TitleSansUnabridged;
+			AaxFile.MetadataItems.Album = AaxFile.MetadataItems.Album?.Replace(" (Unabridged)", "");
+		}
+
+		if (DownloadOptions.FixupFile)
+		{
+			if (!string.IsNullOrWhiteSpace(AaxFile.MetadataItems.Narrator))
+				AaxFile.MetadataItems.AppleListBox.EditOrAddTag("©wrt", AaxFile.MetadataItems.Narrator);
+
+			if (!string.IsNullOrWhiteSpace(AaxFile.MetadataItems.Copyright))
+				AaxFile.MetadataItems.Copyright = AaxFile.MetadataItems.Copyright.Replace("(P)", "℗").Replace("&#169;", "©");
+
+			//Add audiobook shelf tags
+			//https://github.com/advplyr/audiobookshelf/issues/1794#issuecomment-1565050213
+			const string tagDomain = "com.pilabor.tone";
+
+			AaxFile.MetadataItems.Title = DownloadOptions.Title;
+
+			if (DownloadOptions.Subtitle is string subtitle)
+				AaxFile.MetadataItems.AppleListBox.EditOrAddFreeformTag(tagDomain, "SUBTITLE", subtitle);
+
+			if (DownloadOptions.Publisher is string publisher)
+				AaxFile.MetadataItems.AppleListBox.EditOrAddFreeformTag(tagDomain, "PUBLISHER", publisher);
+
+			if (DownloadOptions.Language is string language)
+				AaxFile.MetadataItems.AppleListBox.EditOrAddFreeformTag(tagDomain, "LANGUAGE", language);
+
+			if (DownloadOptions.AudibleProductId is string asin)
+			{
+				AaxFile.MetadataItems.Asin = asin;
+				AaxFile.MetadataItems.AppleListBox.EditOrAddTag("asin", asin);
+				AaxFile.MetadataItems.AppleListBox.EditOrAddFreeformTag(tagDomain, "AUDIBLE_ASIN", asin);
+			}
+
+			if (DownloadOptions.SeriesName is string series)
+				AaxFile.MetadataItems.AppleListBox.EditOrAddFreeformTag(tagDomain, "SERIES", series);
+
+			if (DownloadOptions.SeriesNumber is string part)
+				AaxFile.MetadataItems.AppleListBox.EditOrAddFreeformTag(tagDomain, "PART", part);
+		}
+
+		OnRetrievedTitle(AaxFile.MetadataItems.TitleSansUnabridged);
+		OnRetrievedAuthors(AaxFile.MetadataItems.FirstAuthor);
+		OnRetrievedNarrators(AaxFile.MetadataItems.Narrator);
+		OnRetrievedCoverArt(AaxFile.MetadataItems.Cover);
+		OnInitialized();
+
+		return !IsCanceled;
+	}
+
+	protected virtual void OnInitialized() { }
 }

Source/AaxDecrypter/AaxcDownloadMultiConverter.cs

@@ -1,157 +1,119 @@
 using AAXClean;
 using AAXClean.Codecs;
 using FileManager;
+using Mpeg4Lib;
 using System;
 using System.IO;
 using System.Threading.Tasks;
 
-#nullable enable
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public class AaxcDownloadMultiConverter : AaxcDownloadConvertBase
 {
-	public class AaxcDownloadMultiConverter : AaxcDownloadConvertBase
+	private static readonly TimeSpan minChapterLength = TimeSpan.FromSeconds(3);
+	private FileStream? workingFileStream;
+
+	public AaxcDownloadMultiConverter(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
+		: base(outDirectory, cacheDirectory, dlOptions)
 	{
-		private static readonly TimeSpan minChapterLength = TimeSpan.FromSeconds(3);
-		private FileStream? workingFileStream;
+		AsyncSteps.Name = $"Download, Convert Aaxc To {DownloadOptions.OutputFormat}, and Split";
+		AsyncSteps["Step 1: Get Aaxc Metadata"] = () => Task.Run(Step_GetMetadata);
+		AsyncSteps["Step 2: Download Decrypted Audiobook"] = Step_DownloadAndDecryptAudiobookAsync;
+	}
 
-		public AaxcDownloadMultiConverter(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
-			: base(outDirectory, cacheDirectory, dlOptions)
+	protected override void OnInitialized()
+	{
+		//Finishing configuring lame encoder.
+		if (DownloadOptions.OutputFormat == OutputFormat.Mp3)
 		{
-			AsyncSteps.Name = $"Download, Convert Aaxc To {DownloadOptions.OutputFormat}, and Split";
-			AsyncSteps["Step 1: Get Aaxc Metadata"] = () => Task.Run(Step_GetMetadata);
-			AsyncSteps["Step 2: Download Decrypted Audiobook"] = Step_DownloadAndDecryptAudiobookAsync;
-		}
+			if (AaxFile is null)
+				throw new InvalidOperationException($"AaxFile is null during {nameof(OnInitialized)} in {nameof(AaxcDownloadConvertBase)}.");
+			if (DownloadOptions.LameConfig is null)
+				throw new InvalidOperationException($"LameConfig is null during {nameof(OnInitialized)} in {nameof(DownloadOptions)}.");
 
-		protected override void OnInitialized()
-		{
-			//Finishing configuring lame encoder.
-			if (DownloadOptions.OutputFormat == OutputFormat.Mp3)
-				MpegUtil.ConfigureLameOptions(
-					AaxFile,
-					DownloadOptions.LameConfig,
-					DownloadOptions.Downsample,
-					DownloadOptions.MatchSourceBitrate,
-					chapters: null);
-		}
-
-		/*
-https://github.com/rmcrackan/Libation/pull/127#issuecomment-939088489
-
-If the chapter truly is empty, that is, 0 audio frames in length, then yes it is ignored.
-If the chapter is shorter than 3 seconds long but still has some audio frames, those frames are combined with the following chapter and not split into a new file.
-
-I also implemented file naming by chapter title. When 2 or more consecutive chapters are combined, the first of the combined chapter's title is used in the file name. For example, given an audiobook with the following chapters:
-
-00:00:00 - 00:00:02 | Part 1
-00:00:02 - 00:35:00 | Chapter 1
-00:35:02 - 01:02:00 | Chapter 2
-01:02:00 - 01:02:02 | Part 2
-01:02:02 - 01:41:00 | Chapter 3
-01:41:00 - 02:05:00 | Chapter 4
-
-The book will be split into the following files:
-
-00:00:00 - 00:35:00 | Book - 01 - Part 1.m4b
-00:35:00 - 01:02:00 | Book - 02 - Chapter 2.m4b
-01:02:00 - 01:41:00 | Book - 03 - Part 2.m4b
-01:41:00 - 02:05:00 | Book - 04 - Chapter 4.m4b
-
-That naming may not be desirable for everyone, but it's an easy change to instead use the last of the combined chapter's title in the file name.
-		 */
-		protected async override Task<bool> Step_DownloadAndDecryptAudiobookAsync()
-		{
-			if (AaxFile is null) return false;
-			var chapters = DownloadOptions.ChapterInfo.Chapters;
-
-			// Ensure split files are at least minChapterLength in duration.
-			var splitChapters = new ChapterInfo(DownloadOptions.ChapterInfo.StartOffset);
-
-			var runningTotal = TimeSpan.Zero;
-			string title = "";
-
-			for (int i = 0; i < chapters.Count; i++)
-			{
-				if (runningTotal == TimeSpan.Zero)
-					title = chapters[i].Title;
-
-				runningTotal += chapters[i].Duration;
-
-				if (runningTotal >= minChapterLength)
-				{
-					splitChapters.AddChapter(title, runningTotal);
-					runningTotal = TimeSpan.Zero;
-				}
-			}
-
-			try
-			{
-				await (AaxConversion = decryptMultiAsync(AaxFile, splitChapters));
-
-				if (AaxConversion.IsCompletedSuccessfully)
-					await moveMoovToBeginning(AaxFile, workingFileStream?.Name);
-
-				return AaxConversion.IsCompletedSuccessfully;
-			}
-			finally
-			{
-				workingFileStream?.Dispose();
-				FinalizeDownload();
-			}
-		}
-
-		private Mp4Operation decryptMultiAsync(Mp4File aaxFile, ChapterInfo splitChapters)
-		{
-			var chapterCount = 0;
-			return
-				DownloadOptions.OutputFormat == OutputFormat.M4b
-				? aaxFile.ConvertToMultiMp4aAsync
-				(
-					splitChapters,
-					newSplitCallback => newSplit(++chapterCount, splitChapters, newSplitCallback)
-				)
-				: aaxFile.ConvertToMultiMp3Async
-				(
-					splitChapters,
-					newSplitCallback => newSplit(++chapterCount, splitChapters, newSplitCallback),
-					DownloadOptions.LameConfig
-				);
-
-			void newSplit(int currentChapter, ChapterInfo splitChapters, INewSplitCallback newSplitCallback)
-			{
-				moveMoovToBeginning(aaxFile, workingFileStream?.Name).GetAwaiter().GetResult();
-				var newTempFile = GetNewTempFilePath(DownloadOptions.OutputFormat.ToString());
-				MultiConvertFileProperties props = new()
-				{
-					OutputFileName = newTempFile.FilePath,
-					PartsPosition = currentChapter,
-					PartsTotal = splitChapters.Count,
-					Title = newSplitCallback.Chapter?.Title,
-				};
-
-				newSplitCallback.OutputFile = workingFileStream = createOutputFileStream(props);
-				newSplitCallback.TrackTitle = DownloadOptions.GetMultipartTitle(props);
-				newSplitCallback.TrackNumber = currentChapter;
-				newSplitCallback.TrackCount = splitChapters.Count;
-
-				OnTempFileCreated(newTempFile with { PartProperties = props });
-			}
-
-			FileStream createOutputFileStream(MultiConvertFileProperties multiConvertFileProperties)
-			{
-				FileUtility.SaferDelete(multiConvertFileProperties.OutputFileName);
-				return File.Open(multiConvertFileProperties.OutputFileName, FileMode.OpenOrCreate, FileAccess.ReadWrite);
-			}
-		}
-
-		private Mp4Operation moveMoovToBeginning(Mp4File aaxFile, string? filename)
-		{
-			if (DownloadOptions.OutputFormat is OutputFormat.M4b
-				&& DownloadOptions.MoveMoovToBeginning
-				&& filename is not null
-				&& File.Exists(filename))
-			{
-				return Mp4File.RelocateMoovAsync(filename);
-			}
-			else return Mp4Operation.FromCompleted(aaxFile);
+			MpegUtil.ConfigureLameOptions(
+				AaxFile,
+				DownloadOptions.LameConfig,
+				DownloadOptions.Downsample,
+				DownloadOptions.MatchSourceBitrate,
+				chapters: null);
 		}
 	}
+
+
+	protected override async Task<bool> Step_DownloadAndDecryptAudiobookAsync()
+	{
+		if (AaxFile is null) return false;
+
+		try
+		{
+			await (AaxConversion = decryptMultiAsync(AaxFile, DownloadOptions.ChapterInfo));
+
+			if (AaxConversion.IsCompletedSuccessfully)
+				await moveMoovToBeginning(AaxFile, workingFileStream?.Name);
+
+			return AaxConversion.IsCompletedSuccessfully;
+		}
+		finally
+		{
+			workingFileStream?.Dispose();
+			FinalizeDownload();
+		}
+	}
+
+	private Mp4Operation decryptMultiAsync(Mp4File aaxFile, ChapterInfo splitChapters)
+	{
+		var chapterCount = 0;
+		return
+			DownloadOptions.OutputFormat == OutputFormat.M4b
+			? aaxFile.ConvertToMultiMp4aAsync
+			(
+				splitChapters,
+				newSplitCallback => newSplit(++chapterCount, splitChapters, newSplitCallback)
+			)
+			: aaxFile.ConvertToMultiMp3Async
+			(
+				splitChapters,
+				newSplitCallback => newSplit(++chapterCount, splitChapters, newSplitCallback),
+				DownloadOptions.LameConfig
+			);
+
+		void newSplit(int currentChapter, ChapterInfo splitChapters, INewSplitCallback newSplitCallback)
+		{
+			moveMoovToBeginning(aaxFile, workingFileStream?.Name).GetAwaiter().GetResult();
+			var newTempFile = GetNewTempFilePath(DownloadOptions.OutputFormat.ToString());
+			MultiConvertFileProperties props = new()
+			{
+				OutputFileName = newTempFile.FilePath,
+				PartsPosition = currentChapter,
+				PartsTotal = splitChapters.Count,
+				Title = newSplitCallback.Chapter?.Title,
+			};
+
+			newSplitCallback.OutputFile = workingFileStream = createOutputFileStream(props);
+			newSplitCallback.TrackTitle = DownloadOptions.GetMultipartTitle(props);
+			newSplitCallback.TrackNumber = currentChapter;
+			newSplitCallback.TrackCount = splitChapters.Count;
+
+			OnTempFileCreated(newTempFile with { PartProperties = props });
+		}
+
+		FileStream createOutputFileStream(MultiConvertFileProperties multiConvertFileProperties)
+		{
+			FileUtility.SaferDelete(multiConvertFileProperties.OutputFileName);
+			return File.Open(multiConvertFileProperties.OutputFileName, FileMode.OpenOrCreate, FileAccess.ReadWrite);
+		}
+	}
+
+	private Mp4Operation moveMoovToBeginning(Mp4File aaxFile, string? filename)
+	{
+		if (DownloadOptions.OutputFormat is OutputFormat.M4b
+			&& DownloadOptions.MoveMoovToBeginning
+			&& filename is not null
+			&& File.Exists(filename))
+		{
+			return Mp4File.RelocateMoovAsync(filename);
+		}
+		else return Mp4Operation.FromCompleted(aaxFile);
+	}
 }

Source/AaxDecrypter/AaxcDownloadSingleConverter.cs

@@ -6,103 +6,108 @@ using System;
 using System.IO;
 using System.Threading.Tasks;
 
-#nullable enable
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public class AaxcDownloadSingleConverter : AaxcDownloadConvertBase
 {
-	public class AaxcDownloadSingleConverter : AaxcDownloadConvertBase
+	private readonly AverageSpeed averageSpeed = new();
+	private TempFile? outputTempFile;
+
+	public AaxcDownloadSingleConverter(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
+		: base(outDirectory, cacheDirectory, dlOptions)
 	{
-		private readonly AverageSpeed averageSpeed = new();
-		private TempFile? outputTempFile;
+		var step = 1;
 
-		public AaxcDownloadSingleConverter(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
-			: base(outDirectory, cacheDirectory, dlOptions)
+		AsyncSteps.Name = $"Download and Convert Aaxc To {DownloadOptions.OutputFormat}";
+		AsyncSteps[$"Step {step++}: Get Aaxc Metadata"] = () => Task.Run(Step_GetMetadata);
+		AsyncSteps[$"Step {step++}: Download Decrypted Audiobook"] = Step_DownloadAndDecryptAudiobookAsync;
+		if (DownloadOptions.MoveMoovToBeginning && DownloadOptions.OutputFormat is OutputFormat.M4b)
+			AsyncSteps[$"Step {step++}: Move moov atom to beginning"] = Step_MoveMoov;
+		AsyncSteps[$"Step {step++}: Create Cue"] = Step_CreateCueAsync;
+	}
+
+	protected override void OnInitialized()
+	{
+		//Finishing configuring lame encoder.
+		if (DownloadOptions.OutputFormat == OutputFormat.Mp3)
 		{
-			var step = 1;
+			if (AaxFile is null)
+				throw new InvalidOperationException($"AaxFile is null during {nameof(OnInitialized)} in {nameof(AaxcDownloadConvertBase)}.");
+			if (DownloadOptions.LameConfig is null)
+				throw new InvalidOperationException($"LameConfig is null during {nameof(OnInitialized)} in {nameof(DownloadOptions)}.");
 
-			AsyncSteps.Name = $"Download and Convert Aaxc To {DownloadOptions.OutputFormat}";
-			AsyncSteps[$"Step {step++}: Get Aaxc Metadata"] = () => Task.Run(Step_GetMetadata);
-			AsyncSteps[$"Step {step++}: Download Decrypted Audiobook"] = Step_DownloadAndDecryptAudiobookAsync;
-			if (DownloadOptions.MoveMoovToBeginning && DownloadOptions.OutputFormat is OutputFormat.M4b)
-				AsyncSteps[$"Step {step++}: Move moov atom to beginning"] = Step_MoveMoov;
-			AsyncSteps[$"Step {step++}: Create Cue"] = Step_CreateCueAsync;
+			MpegUtil.ConfigureLameOptions(
+				AaxFile,
+				DownloadOptions.LameConfig,
+				DownloadOptions.Downsample,
+				DownloadOptions.MatchSourceBitrate,
+				DownloadOptions.ChapterInfo);
 		}
+	}
 
-		protected override void OnInitialized()
+	protected override async Task<bool> Step_DownloadAndDecryptAudiobookAsync()
+	{
+		if (AaxFile is null) return false;
+		outputTempFile = GetNewTempFilePath(DownloadOptions.OutputFormat.ToString());
+		FileUtility.SaferDelete(outputTempFile.FilePath);
+
+		using var outputFile = File.Open(outputTempFile.FilePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);
+		OnTempFileCreated(outputTempFile);
+
+		try
 		{
-			//Finishing configuring lame encoder.
-			if (DownloadOptions.OutputFormat == OutputFormat.Mp3)
-				MpegUtil.ConfigureLameOptions(
-					AaxFile,
-					DownloadOptions.LameConfig,
-					DownloadOptions.Downsample,
-					DownloadOptions.MatchSourceBitrate,
-					DownloadOptions.ChapterInfo);
-		}
+			await (AaxConversion = decryptAsync(AaxFile, outputFile));
 
-		protected async override Task<bool> Step_DownloadAndDecryptAudiobookAsync()
-		{
-			if (AaxFile is null) return false;
-			outputTempFile = GetNewTempFilePath(DownloadOptions.OutputFormat.ToString());
-			FileUtility.SaferDelete(outputTempFile.FilePath);
-
-			using var outputFile = File.Open(outputTempFile.FilePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);
-			OnTempFileCreated(outputTempFile);
-
-			try
-			{
-				await (AaxConversion = decryptAsync(AaxFile, outputFile));				
-
-				return AaxConversion.IsCompletedSuccessfully;
-			}
-			finally
-			{
-				FinalizeDownload();
-			}
-		}
-
-		private async Task<bool> Step_MoveMoov()
-		{
-			if (outputTempFile is null) return false;
-			AaxConversion = Mp4File.RelocateMoovAsync(outputTempFile.FilePath);
-			AaxConversion.ConversionProgressUpdate += AaxConversion_MoovProgressUpdate;
-			await AaxConversion;
-			AaxConversion.ConversionProgressUpdate -= AaxConversion_MoovProgressUpdate;
 			return AaxConversion.IsCompletedSuccessfully;
 		}
-
-		private void AaxConversion_MoovProgressUpdate(object? sender, ConversionProgressEventArgs e)
+		finally
 		{
-			averageSpeed.AddPosition(e.ProcessPosition.TotalSeconds);
-
-			var remainingTimeToProcess = (e.EndTime - e.ProcessPosition).TotalSeconds;
-			var estTimeRemaining = remainingTimeToProcess / averageSpeed.Average;
-
-			if (double.IsNormal(estTimeRemaining))
-				OnDecryptTimeRemaining(TimeSpan.FromSeconds(estTimeRemaining));
-
-			OnDecryptProgressUpdate(
-				new DownloadProgress
-				{
-					ProgressPercentage = 100 * e.FractionCompleted,
-					BytesReceived = (long)(InputFileStream.Length * e.FractionCompleted),
-					TotalBytesToReceive = InputFileStream.Length
-				});
+			FinalizeDownload();
 		}
-
-		private Mp4Operation decryptAsync(Mp4File aaxFile, Stream outputFile)
-			=> DownloadOptions.OutputFormat == OutputFormat.Mp3
-			? aaxFile.ConvertToMp3Async
-			(
-				outputFile,
-				DownloadOptions.LameConfig,
-				DownloadOptions.ChapterInfo
-			)
-			: DownloadOptions.FixupFile
-			? aaxFile.ConvertToMp4aAsync
-			(
-				outputFile,
-				DownloadOptions.ChapterInfo
-			)
-			: aaxFile.ConvertToMp4aAsync(outputFile);
 	}
+
+	private async Task<bool> Step_MoveMoov()
+	{
+		if (outputTempFile is null) return false;
+		AaxConversion = Mp4File.RelocateMoovAsync(outputTempFile.FilePath);
+		AaxConversion.ConversionProgressUpdate += AaxConversion_MoovProgressUpdate;
+		await AaxConversion;
+		AaxConversion.ConversionProgressUpdate -= AaxConversion_MoovProgressUpdate;
+		return AaxConversion.IsCompletedSuccessfully;
+	}
+
+	private void AaxConversion_MoovProgressUpdate(object? sender, ConversionProgressEventArgs e)
+	{
+		averageSpeed.AddPosition(e.ProcessPosition.TotalSeconds);
+
+		var remainingTimeToProcess = (e.EndTime - e.ProcessPosition).TotalSeconds;
+		var estTimeRemaining = remainingTimeToProcess / averageSpeed.Average;
+
+		if (double.IsNormal(estTimeRemaining))
+			OnDecryptTimeRemaining(TimeSpan.FromSeconds(estTimeRemaining));
+
+		OnDecryptProgressUpdate(
+			new DownloadProgress
+			{
+				ProgressPercentage = 100 * e.FractionCompleted,
+				BytesReceived = (long)(InputFileStream.Length * e.FractionCompleted),
+				TotalBytesToReceive = InputFileStream.Length
+			});
+	}
+
+	private Mp4Operation decryptAsync(Mp4File aaxFile, Stream outputFile)
+		=> DownloadOptions.OutputFormat == OutputFormat.Mp3
+		? aaxFile.ConvertToMp3Async
+		(
+			outputFile,
+			DownloadOptions.LameConfig,
+			DownloadOptions.ChapterInfo
+		)
+		: DownloadOptions.FixupFile
+		? aaxFile.ConvertToMp4aAsync
+		(
+			outputFile,
+			DownloadOptions.ChapterInfo
+		)
+		: aaxFile.ConvertToMp4aAsync(outputFile);
 }

Source/AaxDecrypter/AudiobookDownloadBase.cs

@@ -6,213 +6,221 @@ using System;
 using System.IO;
 using System.Threading.Tasks;
 
-#nullable enable
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public enum OutputFormat { M4b, Mp3 }
+
+public abstract class AudiobookDownloadBase
 {
-	public enum OutputFormat { M4b, Mp3 }
+	public event EventHandler<string?>? RetrievedTitle;
+	public event EventHandler<string?>? RetrievedAuthors;
+	public event EventHandler<string?>? RetrievedNarrators;
+	public event EventHandler<byte[]?>? RetrievedCoverArt;
+	public event EventHandler<DownloadProgress>? DecryptProgressUpdate;
+	public event EventHandler<TimeSpan>? DecryptTimeRemaining;
+	public event EventHandler<TempFile>? TempFileCreated;
 
-	public abstract class AudiobookDownloadBase
+	public bool IsCanceled { get; protected set; }
+	protected AsyncStepSequence AsyncSteps { get; } = new();
+	protected string OutputDirectory { get; }
+	public IDownloadOptions DownloadOptions { get; }
+	protected NetworkFileStream InputFileStream => NfsPersister.NetworkFileStream;
+	protected virtual long InputFilePosition
 	{
-		public event EventHandler<string?>? RetrievedTitle;
-		public event EventHandler<string?>? RetrievedAuthors;
-		public event EventHandler<string?>? RetrievedNarrators;
-		public event EventHandler<byte[]?>? RetrievedCoverArt;
-		public event EventHandler<DownloadProgress>? DecryptProgressUpdate;
-		public event EventHandler<TimeSpan>? DecryptTimeRemaining;
-		public event EventHandler<TempFile>? TempFileCreated;
+		get
+		{
+			//Use try/catch instread of checking CanRead to avoid
+			//a race with the background download completing
+			//between the check and the Position call.
+			try { return InputFileStream.Position; }
+			catch { return InputFileStream.Length; }
+		}
+	}
+	private bool downloadFinished;
 
-		public bool IsCanceled { get; protected set; }
-		protected AsyncStepSequence AsyncSteps { get; } = new();
-		protected string OutputDirectory { get; }
-		public IDownloadOptions DownloadOptions { get; }
-		protected NetworkFileStream InputFileStream => NfsPersister.NetworkFileStream;
-		protected virtual long InputFilePosition => InputFileStream.Position;
-		private bool downloadFinished;
+	private NetworkFileStreamPersister? m_nfsPersister;
+	private NetworkFileStreamPersister NfsPersister => m_nfsPersister ??= OpenNetworkFileStream();
+	private readonly DownloadProgress zeroProgress;
+	private readonly string jsonDownloadState;
+	private readonly string tempFilePath;
 
-		private NetworkFileStreamPersister? m_nfsPersister;
-		private NetworkFileStreamPersister NfsPersister => m_nfsPersister ??= OpenNetworkFileStream();
-		private readonly DownloadProgress zeroProgress;
-		private readonly string jsonDownloadState;
-		private readonly string tempFilePath;
+	protected AudiobookDownloadBase(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
+	{
+		OutputDirectory = ArgumentValidator.EnsureNotNullOrWhiteSpace(outDirectory, nameof(outDirectory));
+		DownloadOptions = ArgumentValidator.EnsureNotNull(dlOptions, nameof(dlOptions));
+		DownloadOptions.DownloadSpeedChanged += (_, speed) => InputFileStream.SpeedLimit = speed;
 
-		protected AudiobookDownloadBase(string outDirectory, string cacheDirectory, IDownloadOptions dlOptions)
-		{			
-			OutputDirectory = ArgumentValidator.EnsureNotNullOrWhiteSpace(outDirectory, nameof(outDirectory));
-			DownloadOptions = ArgumentValidator.EnsureNotNull(dlOptions, nameof(dlOptions));
-			DownloadOptions.DownloadSpeedChanged += (_, speed) => InputFileStream.SpeedLimit = speed;
+		if (!Directory.Exists(OutputDirectory))
+			Directory.CreateDirectory(OutputDirectory);
 
-			if (!Directory.Exists(OutputDirectory))
-				Directory.CreateDirectory(OutputDirectory);
+		if (!Directory.Exists(cacheDirectory))
+			Directory.CreateDirectory(cacheDirectory);
 
-			if (!Directory.Exists(cacheDirectory))
-				Directory.CreateDirectory(cacheDirectory);
+		jsonDownloadState = Path.Combine(cacheDirectory, $"{DownloadOptions.AudibleProductId}.json");
+		tempFilePath = Path.ChangeExtension(jsonDownloadState, ".aaxc");
 
-			jsonDownloadState = Path.Combine(cacheDirectory, $"{DownloadOptions.AudibleProductId}.json");
-			tempFilePath = Path.ChangeExtension(jsonDownloadState, ".aaxc");
+		zeroProgress = new DownloadProgress
+		{
+			BytesReceived = 0,
+			ProgressPercentage = 0,
+			TotalBytesToReceive = 0
+		};
 
-			zeroProgress = new DownloadProgress
+		OnDecryptProgressUpdate(zeroProgress);
+	}
+
+	protected TempFile GetNewTempFilePath(string extension)
+	{
+		extension = FileUtility.GetStandardizedExtension(extension);
+		var path = Path.Combine(OutputDirectory, Guid.NewGuid().ToString("N") + extension);
+		return new(path, extension);
+	}
+
+	public async Task<bool> RunAsync()
+	{
+		await InputFileStream.BeginDownloadingAsync();
+		var progressTask = Task.Run(reportProgress);
+
+		(bool success, var elapsed) = await AsyncSteps.RunAsync();
+
+		//Stop the downloader so it doesn't keep running in the background.
+		if (!success)
+			NfsPersister.Dispose();
+
+		await progressTask;
+
+		var speedup = DownloadOptions.RuntimeLength / elapsed;
+		Serilog.Log.Information($"Speedup is {speedup:F0}x realtime.");
+
+		NfsPersister.Dispose();
+		return success;
+
+		async Task reportProgress()
+		{
+			AverageSpeed averageSpeed = new();
+
+			while (
+				InputFileStream.CanRead
+				&& InputFileStream.Length > InputFilePosition
+				&& !InputFileStream.IsCancelled
+				&& !downloadFinished)
 			{
-				BytesReceived = 0,
-				ProgressPercentage = 0,
-				TotalBytesToReceive = 0
-			};
+				averageSpeed.AddPosition(InputFilePosition);
 
+				var estSecsRemaining = (InputFileStream.Length - InputFilePosition) / averageSpeed.Average;
+
+				if (double.IsNormal(estSecsRemaining))
+					OnDecryptTimeRemaining(TimeSpan.FromSeconds(estSecsRemaining));
+
+				var progressPercent = 100d * InputFilePosition / InputFileStream.Length;
+
+				OnDecryptProgressUpdate(
+					new DownloadProgress
+					{
+						ProgressPercentage = progressPercent,
+						BytesReceived = InputFilePosition,
+						TotalBytesToReceive = InputFileStream.Length
+					});
+
+				await Task.Delay(200);
+			}
+
+			OnDecryptTimeRemaining(TimeSpan.Zero);
 			OnDecryptProgressUpdate(zeroProgress);
 		}
+	}
 
-		protected TempFile GetNewTempFilePath(string extension)
+	public virtual Task CancelAsync()
+	{
+		IsCanceled = true;
+		FinalizeDownload();
+		return Task.CompletedTask;
+	}
+	protected abstract Task<bool> Step_DownloadAndDecryptAudiobookAsync();
+
+	public virtual void SetCoverArt(byte[] coverArt) { }
+	protected void OnRetrievedTitle(string? title)
+		=> RetrievedTitle?.Invoke(this, title);
+	protected void OnRetrievedAuthors(string? authors)
+		=> RetrievedAuthors?.Invoke(this, authors);
+	protected void OnRetrievedNarrators(string? narrators)
+		=> RetrievedNarrators?.Invoke(this, narrators);
+	protected void OnRetrievedCoverArt(byte[]? coverArt)
+		=> RetrievedCoverArt?.Invoke(this, coverArt);
+	protected void OnDecryptProgressUpdate(DownloadProgress downloadProgress)
+		=> DecryptProgressUpdate?.Invoke(this, downloadProgress);
+	protected void OnDecryptTimeRemaining(TimeSpan timeRemaining)
+		=> DecryptTimeRemaining?.Invoke(this, timeRemaining);
+	public void OnTempFileCreated(TempFile path)
+		=> TempFileCreated?.Invoke(this, path);
+
+	protected virtual void FinalizeDownload()
+	{
+		NfsPersister.Dispose();
+		downloadFinished = true;
+	}
+
+	protected async Task<bool> Step_CreateCueAsync()
+	{
+		if (!DownloadOptions.CreateCueSheet) return !IsCanceled;
+
+		if (DownloadOptions.ChapterInfo.Count <= 1)
 		{
-			extension = FileUtility.GetStandardizedExtension(extension);
-			var path = Path.Combine(OutputDirectory, Guid.NewGuid().ToString("N") + extension);
-			return new(path, extension);
-		}
-
-		public async Task<bool> RunAsync()
-		{
-			await InputFileStream.BeginDownloadingAsync();
-			var progressTask = Task.Run(reportProgress);
-
-			(bool success, var elapsed) = await AsyncSteps.RunAsync();
-
-			//Stop the downloader so it doesn't keep running in the background.
-			if (!success)
-				NfsPersister.Dispose();
-
-			await progressTask;
-
-			var speedup = DownloadOptions.RuntimeLength / elapsed;
-			Serilog.Log.Information($"Speedup is {speedup:F0}x realtime.");
-
-			NfsPersister.Dispose();
-			return success;
-
-			async Task reportProgress()
-			{
-				AverageSpeed averageSpeed = new();
-
-				while (
-					InputFileStream.CanRead
-					&& InputFileStream.Length > InputFilePosition
-					&& !InputFileStream.IsCancelled
-					&& !downloadFinished)
-				{
-					averageSpeed.AddPosition(InputFilePosition);
-
-					var estSecsRemaining = (InputFileStream.Length - InputFilePosition) / averageSpeed.Average;
-
-					if (double.IsNormal(estSecsRemaining))
-						OnDecryptTimeRemaining(TimeSpan.FromSeconds(estSecsRemaining));
-
-					var progressPercent = 100d * InputFilePosition / InputFileStream.Length;
-
-					OnDecryptProgressUpdate(
-						new DownloadProgress
-						{
-							ProgressPercentage = progressPercent,
-							BytesReceived = InputFilePosition,
-							TotalBytesToReceive = InputFileStream.Length
-						});
-
-					await Task.Delay(200);
-				}
-
-				OnDecryptTimeRemaining(TimeSpan.Zero);
-				OnDecryptProgressUpdate(zeroProgress);
-			}
-		}
-
-		public virtual Task CancelAsync()
-		{
-			IsCanceled = true;
-			FinalizeDownload();
-			return Task.CompletedTask;
-		}
-		protected abstract Task<bool> Step_DownloadAndDecryptAudiobookAsync();
-
-		public virtual void SetCoverArt(byte[] coverArt) { }
-		protected void OnRetrievedTitle(string? title)
-			=> RetrievedTitle?.Invoke(this, title);
-		protected void OnRetrievedAuthors(string? authors)
-			=> RetrievedAuthors?.Invoke(this, authors);
-		protected void OnRetrievedNarrators(string? narrators)
-			=> RetrievedNarrators?.Invoke(this, narrators);
-		protected void OnRetrievedCoverArt(byte[]? coverArt)
-			=> RetrievedCoverArt?.Invoke(this, coverArt);
-		protected void OnDecryptProgressUpdate(DownloadProgress downloadProgress)
-			=> DecryptProgressUpdate?.Invoke(this, downloadProgress);
-		protected void OnDecryptTimeRemaining(TimeSpan timeRemaining)
-			=> DecryptTimeRemaining?.Invoke(this, timeRemaining);
-		public void OnTempFileCreated(TempFile path)
-			=> TempFileCreated?.Invoke(this, path);
-
-		protected virtual void FinalizeDownload()
-		{
-			NfsPersister.Dispose();
-			downloadFinished = true;
-		}
-
-		protected async Task<bool> Step_CreateCueAsync()
-		{
-			if (!DownloadOptions.CreateCueSheet) return !IsCanceled;
-
-			if (DownloadOptions.ChapterInfo.Count <= 1)
-			{
-				Serilog.Log.Logger.Information($"Skipped creating .cue because book has no chapters.");
-				return !IsCanceled;
-			}
-
-			// not a critical step. its failure should not prevent future steps from running
-			try
-			{
-				var tempFile = GetNewTempFilePath(".cue");
-				await File.WriteAllTextAsync(tempFile.FilePath, Cue.CreateContents(Path.GetFileName(tempFile.FilePath), DownloadOptions.ChapterInfo));
-				OnTempFileCreated(tempFile);
-			}
-			catch (Exception ex)
-			{
-				Serilog.Log.Logger.Error(ex, $"{nameof(Step_CreateCueAsync)} Failed");
-			}
+			Serilog.Log.Logger.Information($"Skipped creating .cue because book has no chapters.");
 			return !IsCanceled;
 		}
 
-		private NetworkFileStreamPersister OpenNetworkFileStream()
+		// not a critical step. its failure should not prevent future steps from running
+		try
 		{
-			NetworkFileStreamPersister? nfsp = default;
-			try
-			{
-				if (!File.Exists(jsonDownloadState))
-					return nfsp = newNetworkFilePersister();
+			var tempFile = GetNewTempFilePath(".cue");
+			await File.WriteAllTextAsync(tempFile.FilePath, Cue.CreateContents(Path.GetFileName(tempFile.FilePath), DownloadOptions.ChapterInfo));
+			OnTempFileCreated(tempFile);
+		}
+		catch (Exception ex)
+		{
+			Serilog.Log.Logger.Error(ex, $"{nameof(Step_CreateCueAsync)} Failed");
+		}
+		return !IsCanceled;
+	}
 
-				nfsp = new NetworkFileStreamPersister(jsonDownloadState);
-				// The download url expires after 1 hour.
-				// The new url points to the same file.
-				nfsp.NetworkFileStream.SetUriForSameFile(new Uri(DownloadOptions.DownloadUrl));
-				return nfsp;
-			}
-			catch
-			{
-				nfsp?.Target?.Dispose();
-				FileUtility.SaferDelete(jsonDownloadState);
-				FileUtility.SaferDelete(tempFilePath);
+	private NetworkFileStreamPersister OpenNetworkFileStream()
+	{
+		NetworkFileStreamPersister? nfsp = default;
+		try
+		{
+			if (!File.Exists(jsonDownloadState))
 				return nfsp = newNetworkFilePersister();
-			}
-			finally
-			{
-				//nfsp will only be null when an unhandled exception occurs. Let the caller handle it.
-				if (nfsp is not null)
-				{
-					nfsp.NetworkFileStream.RequestHeaders["User-Agent"] = DownloadOptions.UserAgent;
-					nfsp.NetworkFileStream.SpeedLimit = DownloadOptions.DownloadSpeedBps;
-					OnTempFileCreated(new(tempFilePath, DownloadOptions.InputType.ToString()));
-					OnTempFileCreated(new(jsonDownloadState));
-				}
-			}
 
-			NetworkFileStreamPersister newNetworkFilePersister()
+			nfsp = new NetworkFileStreamPersister(jsonDownloadState);
+			// The download url expires after 1 hour.
+			// The new url points to the same file.
+			nfsp.NetworkFileStream.SetUriForSameFile(new Uri(DownloadOptions.DownloadUrl));
+			return nfsp;
+		}
+		catch
+		{
+			nfsp?.Target?.Dispose();
+			FileUtility.SaferDelete(jsonDownloadState);
+			FileUtility.SaferDelete(tempFilePath);
+			return nfsp = newNetworkFilePersister();
+		}
+		finally
+		{
+			//nfsp will only be null when an unhandled exception occurs. Let the caller handle it.
+			if (nfsp is not null)
 			{
-				var networkFileStream = new NetworkFileStream(tempFilePath, new Uri(DownloadOptions.DownloadUrl), 0, new() { { "User-Agent", DownloadOptions.UserAgent } });
-				return new NetworkFileStreamPersister(networkFileStream, jsonDownloadState);
+				nfsp.NetworkFileStream.RequestHeaders["User-Agent"] = DownloadOptions.UserAgent;
+				nfsp.NetworkFileStream.SpeedLimit = DownloadOptions.DownloadSpeedBps;
+				OnTempFileCreated(new(tempFilePath, DownloadOptions.InputType.ToString()));
+				OnTempFileCreated(new(jsonDownloadState));
 			}
 		}
+
+		NetworkFileStreamPersister newNetworkFilePersister()
+		{
+			var networkFileStream = new NetworkFileStream(tempFilePath, new Uri(DownloadOptions.DownloadUrl), 0, new() { { "User-Agent", DownloadOptions.UserAgent } });
+			return new NetworkFileStreamPersister(networkFileStream, jsonDownloadState);
+		}
 	}
 }

Source/AaxDecrypter/AverageSpeed.cs

@@ -66,13 +66,13 @@ public static class LinqStats
 	/// 2-tailed  t-Distribution critical values at 75%, 80%, 85%,
 	/// 90%, 95%, and 99% confidence for 1 - 201 degrees of freedom.
 	/// </summary>
-	private readonly static double[][] T_TABLE;
-	private readonly static double[] T_Table_25 = { 2.414213562, 1.603567451, 1.422625281, 1.344397556, 1.300949037, 1.273349309, 1.254278682, 1.240318261, 1.229659173, 1.221255395, 1.214460246, 1.208852542, 1.204146242, 1.200140298, 1.196689284, 1.193685414, 1.191047107, 1.188711483, 1.186629298, 1.184761434, 1.183076432, 1.181548697, 1.180157199, 1.178884497, 1.177716003, 1.176639425, 1.175644329, 1.174721803, 1.173864189, 1.173064871, 1.1723181, 1.17161886, 1.170962753, 1.17034591, 1.169764906, 1.169216709, 1.168698615, 1.168208212, 1.167743338, 1.167302049, 1.166882595, 1.166483396, 1.166103019, 1.165740162, 1.165393644, 1.165062385, 1.164745398, 1.164441782, 1.164150707, 1.163871412, 1.163603196, 1.163345413, 1.163097467, 1.162858803, 1.162628911, 1.162407316, 1.162193577, 1.161987283, 1.161788052, 1.161595527, 1.161409375, 1.161229286, 1.161054967, 1.160886145, 1.160722566, 1.160563987, 1.160410184, 1.160260944, 1.160116066, 1.159975363, 1.159838656, 1.159705777, 1.159576569, 1.15945088, 1.15932857, 1.159209503, 1.159093552, 1.158980598, 1.158870524, 1.158763222, 1.158658589, 1.158556526, 1.15845694, 1.158359742, 1.158264847, 1.158172173, 1.158081645, 1.157993188, 1.157906731, 1.157822209, 1.157739556, 1.157658712, 1.157579617, 1.157502216, 1.157426454, 1.157352281, 1.157279646, 1.157208502, 1.157138804, 1.157070509, 1.157003573, 1.156937958, 1.156873624, 1.156810534, 1.156748653, 1.156687945, 1.156628379, 1.156569922, 1.156512543, 1.156456213, 1.156400904, 1.156346587, 1.156293237, 1.156240827, 1.156189334, 1.156138733, 1.156089001, 1.156040117, 1.155992058, 1.155944804, 1.155898335, 1.155852631, 1.155807674, 1.155763446, 1.155719928, 1.155677105, 1.155634959, 1.155593475, 1.155552637, 1.15551243, 1.155472839, 1.155433851, 1.155395452, 1.155357629, 1.155320368, 1.155283658, 1.155247486, 1.155211841, 1.15517671, 1.155142084, 1.15510795, 1.1550743, 1.155041122, 1.155008406, 1.154976144, 1.154944326, 1.154912942, 1.154881984, 1.154851443, 1.154821311, 1.15479158, 1.154762241, 1.154733287, 1.154704711, 1.154676505, 1.154648662, 1.154621175, 1.154594037, 1.154567242, 1.154540783, 1.154514654, 1.154488849, 1.154463361, 1.154438185, 1.154413316, 1.154388747, 1.154364474, 1.15434049, 1.154316792, 1.154293373, 1.154270229, 1.154247355, 1.154224746, 1.154202398, 1.154180307, 1.154158467, 1.154136875, 1.154115526, 1.154094417, 1.154073543, 1.1540529, 1.154032485, 1.154012294, 1.153992323, 1.153972568, 1.153953027, 1.153933695, 1.15391457, 1.153895647, 1.153876925, 1.153858399, 1.153840066, 1.153821925, 1.15380397, 1.153786201, 1.153768613, 1.153751204, 1.153733972, 1.153716914, 1.153700026 };
-	private readonly static double[] T_Table_20 = { 3.077683537, 1.885618083, 1.637744354, 1.533206274, 1.475884049, 1.439755747, 1.414923928, 1.39681531, 1.383028738, 1.372183641, 1.363430318, 1.356217334, 1.350171289, 1.345030374, 1.340605608, 1.336757167, 1.33337939, 1.330390944, 1.327728209, 1.325340707, 1.323187874, 1.321236742, 1.31946024, 1.317835934, 1.316345073, 1.314971864, 1.313702913, 1.312526782, 1.311433647, 1.310415025, 1.309463549, 1.308572793, 1.307737124, 1.306951587, 1.306211802, 1.305513886, 1.304854381, 1.304230204, 1.303638589, 1.303077053, 1.302543359, 1.302035487, 1.301551608, 1.30109006, 1.300649332, 1.300228048, 1.299824947, 1.299438879, 1.299068785, 1.298713694, 1.298372713, 1.298045016, 1.297729843, 1.297426488, 1.2971343, 1.296852673, 1.296581044, 1.29631889, 1.296065725, 1.295821094, 1.295584571, 1.295355762, 1.295134294, 1.29491982, 1.294712013, 1.294510568, 1.294315197, 1.294125629, 1.293941609, 1.293762898, 1.293589269, 1.293420507, 1.293256413, 1.293096793, 1.292941469, 1.292790268, 1.292643029, 1.292499597, 1.292359828, 1.292223583, 1.29209073, 1.291961144, 1.291834705, 1.291711301, 1.291590824, 1.291473171, 1.291358243, 1.291245948, 1.291136195, 1.291028899, 1.290923979, 1.290821356, 1.290720956, 1.290622708, 1.290526543, 1.290432395, 1.290340202, 1.290249904, 1.290161442, 1.290074761, 1.289989809, 1.289906533, 1.289824884, 1.289744816, 1.289666283, 1.289589241, 1.289513648, 1.289439464, 1.289366649, 1.289295166, 1.289224979, 1.289156054, 1.289088355, 1.289021851, 1.28895651, 1.288892302, 1.288829199, 1.288767171, 1.288706191, 1.288646234, 1.288587273, 1.288529284, 1.288472243, 1.288416127, 1.288360913, 1.288306581, 1.288253109, 1.288200477, 1.288148665, 1.288097654, 1.288047427, 1.287997964, 1.287949248, 1.287901264, 1.287853994, 1.287807422, 1.287761534, 1.287716314, 1.287671748, 1.287627821, 1.287584521, 1.287541833, 1.287499745, 1.287458245, 1.287417319, 1.287376957, 1.287337146, 1.287297876, 1.287259135, 1.287220914, 1.2871832, 1.287145985, 1.287109259, 1.287073012, 1.287037235, 1.287001918, 1.286967053, 1.286932631, 1.286898644, 1.286865084, 1.286831942, 1.286799212, 1.286766884, 1.286734952, 1.286703409, 1.286672248, 1.286641461, 1.286611042, 1.286580985, 1.286551283, 1.286521929, 1.286492918, 1.286464244, 1.286435901, 1.286407882, 1.286380184, 1.286352799, 1.286325724, 1.286298952, 1.286272479, 1.286246299, 1.286220408, 1.286194801, 1.286169474, 1.286144421, 1.286119638, 1.286095122, 1.286070867, 1.28604687, 1.286023127, 1.285999633, 1.285976384, 1.285953377, 1.285930609, 1.285908074, 1.285885771, 1.285863694, 1.285841842, 1.285820209, 1.285798794 };
-	private readonly static double[] T_Table_15 = { 4.16529977, 2.281930588, 1.924319657, 1.778192164, 1.699362566, 1.650173154, 1.616591737, 1.59222144, 1.573735785, 1.559235933, 1.547559766, 1.537956495, 1.529919606, 1.523095061, 1.517227969, 1.51213017, 1.507659754, 1.503707672, 1.500188756, 1.497035518, 1.494193795, 1.491619612, 1.489276897, 1.487135783, 1.485171326, 1.483362535, 1.481691617, 1.48014339, 1.478704821, 1.477364662, 1.47611315, 1.474941772, 1.473843072, 1.47281049, 1.471838233, 1.470921166, 1.470054719, 1.469234815, 1.468457801, 1.467720399, 1.467019655, 1.466352901, 1.465717725, 1.465111933, 1.464533534, 1.463980712, 1.463451805, 1.462945295, 1.46245979, 1.461994009, 1.461546775, 1.461117, 1.460703683, 1.460305896, 1.45992278, 1.459553538, 1.45919743, 1.458853767, 1.458521908, 1.458201256, 1.457891251, 1.457591373, 1.457301133, 1.457020074, 1.456747768, 1.45648381, 1.456227824, 1.455979454, 1.455738365, 1.455504241, 1.455276784, 1.455055715, 1.454840767, 1.45463169, 1.454428246, 1.454230212, 1.454037373, 1.453849529, 1.453666487, 1.453488066, 1.453314093, 1.453144404, 1.452978842, 1.452817259, 1.452659513, 1.452505469, 1.452354998, 1.452207977, 1.452064289, 1.451923821, 1.451786468, 1.451652126, 1.451520697, 1.451392088, 1.451266209, 1.451142973, 1.451022299, 1.450904108, 1.450788323, 1.450674871, 1.450563684, 1.450454694, 1.450347836, 1.450243048, 1.450140271, 1.450039448, 1.449940523, 1.449843444, 1.449748158, 1.449654617, 1.449562773, 1.449472581, 1.449383997, 1.449296977, 1.449211481, 1.449127468, 1.449044902, 1.448963744, 1.448883959, 1.448805513, 1.448728372, 1.448652503, 1.448577876, 1.44850446, 1.448432226, 1.448361146, 1.448291192, 1.448222337, 1.448154557, 1.448087826, 1.44802212, 1.447957415, 1.447893688, 1.447830919, 1.447769085, 1.447708165, 1.44764814, 1.44758899, 1.447530695, 1.447473238, 1.447416601, 1.447360765, 1.447305715, 1.447251433, 1.447197905, 1.447145113, 1.447093044, 1.447041682, 1.446991013, 1.446941023, 1.446891698, 1.446843026, 1.446794994, 1.446747588, 1.446700797, 1.446654609, 1.446609012, 1.446563996, 1.446519548, 1.446475659, 1.446432318, 1.446389514, 1.446347238, 1.44630548, 1.44626423, 1.44622348, 1.44618322, 1.446143442, 1.446104137, 1.446065296, 1.446026911, 1.445988975, 1.44595148, 1.445914417, 1.44587778, 1.445841561, 1.445805753, 1.445770349, 1.445735343, 1.445700727, 1.445666495, 1.445632641, 1.445599159, 1.445566042, 1.445533284, 1.445500881, 1.445468825, 1.445437112, 1.445405736, 1.445374691, 1.445343973, 1.445313576, 1.445283495, 1.445253726, 1.445224264, 1.445195103, 1.445166239, 1.445137668, 1.445109385, 1.445081387 };
-	private readonly static double[] T_Table_10 = { 6.313751515, 2.91998558, 2.353363435, 2.131846786, 2.015048373, 1.943180281, 1.894578605, 1.859548038, 1.833112933, 1.812461123, 1.795884819, 1.782287556, 1.770933396, 1.761310136, 1.753050356, 1.745883676, 1.739606726, 1.734063607, 1.729132812, 1.724718243, 1.720742903, 1.717144374, 1.713871528, 1.71088208, 1.708140761, 1.70561792, 1.703288446, 1.701130934, 1.699127027, 1.697260887, 1.695518783, 1.693888748, 1.692360309, 1.690924255, 1.689572458, 1.688297714, 1.68709362, 1.68595446, 1.684875122, 1.683851013, 1.682878002, 1.681952357, 1.681070703, 1.680229977, 1.679427393, 1.678660414, 1.677926722, 1.677224196, 1.676550893, 1.675905025, 1.67528495, 1.674689154, 1.674116237, 1.673564906, 1.673033965, 1.672522303, 1.672028888, 1.671552762, 1.671093032, 1.670648865, 1.670219484, 1.669804163, 1.669402222, 1.669013025, 1.668635976, 1.668270514, 1.667916114, 1.667572281, 1.667238549, 1.666914479, 1.666599658, 1.666293696, 1.665996224, 1.665706893, 1.665425373, 1.665151353, 1.664884537, 1.664624645, 1.664371409, 1.664124579, 1.663883913, 1.663649184, 1.663420175, 1.663196679, 1.6629785, 1.662765449, 1.662557349, 1.662354029, 1.662155326, 1.661961084, 1.661771155, 1.661585397, 1.661403674, 1.661225855, 1.661051817, 1.66088144, 1.66071461, 1.660551217, 1.660391156, 1.660234326, 1.66008063, 1.659929976, 1.659782273, 1.659637437, 1.659495383, 1.659356034, 1.659219312, 1.659085144, 1.658953458, 1.658824187, 1.658697265, 1.658572629, 1.658450216, 1.658329969, 1.65821183, 1.658095744, 1.657981659, 1.657869522, 1.657759285, 1.657650899, 1.657544319, 1.657439499, 1.657336397, 1.65723497, 1.657135178, 1.657036982, 1.656940344, 1.656845226, 1.656751594, 1.656659413, 1.656568649, 1.65647927, 1.656391244, 1.656304542, 1.656219133, 1.656134988, 1.65605208, 1.655970382, 1.655889868, 1.655810511, 1.655732287, 1.655655173, 1.655579143, 1.655504177, 1.655430251, 1.655357345, 1.655285437, 1.655214506, 1.655144534, 1.6550755, 1.655007387, 1.654940175, 1.654873847, 1.654808385, 1.654743774, 1.654679996, 1.654617035, 1.654554875, 1.654493503, 1.654432901, 1.654373057, 1.654313957, 1.654255585, 1.654197929, 1.654140976, 1.654084713, 1.654029128, 1.653974208, 1.653919942, 1.653866317, 1.653813324, 1.653760949, 1.653709184, 1.653658017, 1.653607437, 1.653557435, 1.653508002, 1.653459126, 1.6534108, 1.653363013, 1.653315758, 1.653269024, 1.653222803, 1.653177088, 1.653131869, 1.653087138, 1.653042889, 1.652999113, 1.652955802, 1.652912949, 1.652870547, 1.652828589, 1.652787068, 1.652745977, 1.65270531, 1.652665059, 1.652625219, 1.652585784, 1.652546746, 1.652508101 };
-	private readonly static double[] T_Table_05 = { 12.70620474, 4.30265273, 3.182446305, 2.776445105, 2.570581836, 2.446911851, 2.364624252, 2.306004135, 2.262157163, 2.228138852, 2.20098516, 2.17881283, 2.160368656, 2.144786688, 2.131449546, 2.119905299, 2.109815578, 2.10092204, 2.093024054, 2.085963447, 2.079613845, 2.073873068, 2.06865761, 2.063898562, 2.059538553, 2.055529439, 2.051830516, 2.048407142, 2.045229642, 2.042272456, 2.039513446, 2.036933343, 2.034515297, 2.032244509, 2.030107928, 2.028094001, 2.026192463, 2.024394164, 2.02269092, 2.02107539, 2.01954097, 2.018081703, 2.016692199, 2.015367574, 2.014103389, 2.012895599, 2.011740514, 2.010634758, 2.009575237, 2.008559112, 2.00758377, 2.006646805, 2.005745995, 2.004879288, 2.004044783, 2.003240719, 2.002465459, 2.001717484, 2.000995378, 2.000297822, 1.999623585, 1.998971517, 1.998340543, 1.997729654, 1.997137908, 1.996564419, 1.996008354, 1.995468931, 1.994945415, 1.994437112, 1.993943368, 1.993463567, 1.992997126, 1.992543495, 1.992102154, 1.99167261, 1.991254395, 1.990847069, 1.99045021, 1.990063421, 1.989686323, 1.989318557, 1.98895978, 1.988609667, 1.988267907, 1.987934206, 1.987608282, 1.987289865, 1.9869787, 1.986674541, 1.986377154, 1.986086317, 1.985801814, 1.985523442, 1.985251004, 1.984984312, 1.984723186, 1.984467455, 1.984216952, 1.983971519, 1.983731003, 1.983495259, 1.983264145, 1.983037526, 1.982815274, 1.982597262, 1.98238337, 1.982173483, 1.98196749, 1.981765282, 1.981566757, 1.981371815, 1.981180359, 1.980992298, 1.980807541, 1.980626002, 1.980447599, 1.980272249, 1.980099876, 1.979930405, 1.979763763, 1.979599878, 1.979438685, 1.979280117, 1.979124109, 1.978970602, 1.978819535, 1.97867085, 1.978524491, 1.978380405, 1.978238539, 1.978098842, 1.977961264, 1.977825758, 1.977692277, 1.977560777, 1.977431212, 1.977303542, 1.977177724, 1.97705372, 1.976931489, 1.976810994, 1.976692198, 1.976575066, 1.976459563, 1.976345655, 1.976233309, 1.976122494, 1.976013178, 1.975905331, 1.975798924, 1.975693928, 1.975590315, 1.975488058, 1.975387131, 1.975287508, 1.975189163, 1.975092073, 1.974996213, 1.97490156, 1.974808092, 1.974715786, 1.974624621, 1.974534576, 1.97444563, 1.974357764, 1.974270957, 1.974185191, 1.974100447, 1.974016708, 1.973933954, 1.973852169, 1.973771337, 1.97369144, 1.973612462, 1.973534388, 1.973457202, 1.973380889, 1.973305434, 1.973230823, 1.973157042, 1.973084077, 1.973011915, 1.972940542, 1.972869946, 1.972800114, 1.972731033, 1.972662692, 1.972595079, 1.972528182, 1.97246199, 1.972396491, 1.972331676, 1.972267533, 1.972204051, 1.972141222, 1.972079034, 1.972017478, 1.971956544, 1.971896224 };
-	private readonly static double[] T_Table_01 = { 63.65674116, 9.924843201, 5.84090931, 4.604094871, 4.032142984, 3.707428021, 3.499483297, 3.355387331, 3.249835542, 3.169272673, 3.105806516, 3.054539589, 3.012275839, 2.976842734, 2.946712883, 2.920781622, 2.89823052, 2.878440473, 2.860934606, 2.84533971, 2.831359558, 2.818756061, 2.807335684, 2.796939505, 2.787435814, 2.778714533, 2.770682957, 2.763262455, 2.756385904, 2.749995654, 2.744041919, 2.738481482, 2.733276642, 2.728394367, 2.723805589, 2.71948463, 2.715408722, 2.711557602, 2.707913184, 2.704459267, 2.701181304, 2.698066186, 2.695102079, 2.692278266, 2.689585019, 2.687013492, 2.684555618, 2.682204027, 2.679951974, 2.677793271, 2.675722234, 2.673733631, 2.671822636, 2.669984796, 2.668215988, 2.666512398, 2.664870482, 2.663286954, 2.661758752, 2.660283029, 2.658857127, 2.657478565, 2.656145025, 2.654854337, 2.653604469, 2.652393515, 2.651219685, 2.650081299, 2.648976774, 2.647904624, 2.646863444, 2.645851913, 2.644868782, 2.643912872, 2.642983067, 2.642078313, 2.641197611, 2.640340015, 2.639504627, 2.638690596, 2.637897113, 2.63712341, 2.636368757, 2.635632458, 2.634913852, 2.634212309, 2.633527229, 2.632858038, 2.632204191, 2.631565166, 2.630940463, 2.630329608, 2.629732145, 2.629147638, 2.628575671, 2.628015844, 2.627467774, 2.626931096, 2.626405457, 2.625890521, 2.625385965, 2.624891476, 2.624406758, 2.623931523, 2.623465496, 2.623008411, 2.622560015, 2.622120061, 2.621688313, 2.621264543, 2.620848534, 2.620440073, 2.620038957, 2.619644989, 2.619257981, 2.618877749, 2.618504116, 2.618136914, 2.617775976, 2.617421145, 2.617072266, 2.616729191, 2.616391776, 2.616059883, 2.615733377, 2.615412127, 2.615096008, 2.614784899, 2.61447868, 2.614177238, 2.613880461, 2.613588242, 2.613300477, 2.613017065, 2.612737908, 2.61246291, 2.61219198, 2.611925028, 2.611661966, 2.611402711, 2.611147181, 2.610895295, 2.610646976, 2.61040215, 2.610160742, 2.609922682, 2.609687901, 2.609456331, 2.609227907, 2.609002566, 2.608780245, 2.608560883, 2.608344423, 2.608130807, 2.60791998, 2.607711886, 2.607506474, 2.607303692, 2.607103489, 2.606905817, 2.606710628, 2.606517876, 2.606327515, 2.606139501, 2.605953791, 2.605770342, 2.605589114, 2.605410067, 2.605233162, 2.605058359, 2.604885623, 2.604714916, 2.604546204, 2.60437945, 2.604214622, 2.604051686, 2.60389061, 2.603731363, 2.603573912, 2.603418229, 2.603264282, 2.603112045, 2.602961487, 2.602812582, 2.602665303, 2.602519622, 2.602375515, 2.602232955, 2.602091918, 2.60195238, 2.601814317, 2.601677705, 2.601542523, 2.601408747, 2.601276355, 2.601145327, 2.601015642, 2.600887278, 2.600760216, 2.600634436 };
+	private static readonly double[][] T_TABLE;
+	private static readonly double[] T_Table_25 = { 2.414213562, 1.603567451, 1.422625281, 1.344397556, 1.300949037, 1.273349309, 1.254278682, 1.240318261, 1.229659173, 1.221255395, 1.214460246, 1.208852542, 1.204146242, 1.200140298, 1.196689284, 1.193685414, 1.191047107, 1.188711483, 1.186629298, 1.184761434, 1.183076432, 1.181548697, 1.180157199, 1.178884497, 1.177716003, 1.176639425, 1.175644329, 1.174721803, 1.173864189, 1.173064871, 1.1723181, 1.17161886, 1.170962753, 1.17034591, 1.169764906, 1.169216709, 1.168698615, 1.168208212, 1.167743338, 1.167302049, 1.166882595, 1.166483396, 1.166103019, 1.165740162, 1.165393644, 1.165062385, 1.164745398, 1.164441782, 1.164150707, 1.163871412, 1.163603196, 1.163345413, 1.163097467, 1.162858803, 1.162628911, 1.162407316, 1.162193577, 1.161987283, 1.161788052, 1.161595527, 1.161409375, 1.161229286, 1.161054967, 1.160886145, 1.160722566, 1.160563987, 1.160410184, 1.160260944, 1.160116066, 1.159975363, 1.159838656, 1.159705777, 1.159576569, 1.15945088, 1.15932857, 1.159209503, 1.159093552, 1.158980598, 1.158870524, 1.158763222, 1.158658589, 1.158556526, 1.15845694, 1.158359742, 1.158264847, 1.158172173, 1.158081645, 1.157993188, 1.157906731, 1.157822209, 1.157739556, 1.157658712, 1.157579617, 1.157502216, 1.157426454, 1.157352281, 1.157279646, 1.157208502, 1.157138804, 1.157070509, 1.157003573, 1.156937958, 1.156873624, 1.156810534, 1.156748653, 1.156687945, 1.156628379, 1.156569922, 1.156512543, 1.156456213, 1.156400904, 1.156346587, 1.156293237, 1.156240827, 1.156189334, 1.156138733, 1.156089001, 1.156040117, 1.155992058, 1.155944804, 1.155898335, 1.155852631, 1.155807674, 1.155763446, 1.155719928, 1.155677105, 1.155634959, 1.155593475, 1.155552637, 1.15551243, 1.155472839, 1.155433851, 1.155395452, 1.155357629, 1.155320368, 1.155283658, 1.155247486, 1.155211841, 1.15517671, 1.155142084, 1.15510795, 1.1550743, 1.155041122, 1.155008406, 1.154976144, 1.154944326, 1.154912942, 1.154881984, 1.154851443, 1.154821311, 1.15479158, 1.154762241, 1.154733287, 1.154704711, 1.154676505, 1.154648662, 1.154621175, 1.154594037, 1.154567242, 1.154540783, 1.154514654, 1.154488849, 1.154463361, 1.154438185, 1.154413316, 1.154388747, 1.154364474, 1.15434049, 1.154316792, 1.154293373, 1.154270229, 1.154247355, 1.154224746, 1.154202398, 1.154180307, 1.154158467, 1.154136875, 1.154115526, 1.154094417, 1.154073543, 1.1540529, 1.154032485, 1.154012294, 1.153992323, 1.153972568, 1.153953027, 1.153933695, 1.15391457, 1.153895647, 1.153876925, 1.153858399, 1.153840066, 1.153821925, 1.15380397, 1.153786201, 1.153768613, 1.153751204, 1.153733972, 1.153716914, 1.153700026 };
+	private static readonly double[] T_Table_20 = { 3.077683537, 1.885618083, 1.637744354, 1.533206274, 1.475884049, 1.439755747, 1.414923928, 1.39681531, 1.383028738, 1.372183641, 1.363430318, 1.356217334, 1.350171289, 1.345030374, 1.340605608, 1.336757167, 1.33337939, 1.330390944, 1.327728209, 1.325340707, 1.323187874, 1.321236742, 1.31946024, 1.317835934, 1.316345073, 1.314971864, 1.313702913, 1.312526782, 1.311433647, 1.310415025, 1.309463549, 1.308572793, 1.307737124, 1.306951587, 1.306211802, 1.305513886, 1.304854381, 1.304230204, 1.303638589, 1.303077053, 1.302543359, 1.302035487, 1.301551608, 1.30109006, 1.300649332, 1.300228048, 1.299824947, 1.299438879, 1.299068785, 1.298713694, 1.298372713, 1.298045016, 1.297729843, 1.297426488, 1.2971343, 1.296852673, 1.296581044, 1.29631889, 1.296065725, 1.295821094, 1.295584571, 1.295355762, 1.295134294, 1.29491982, 1.294712013, 1.294510568, 1.294315197, 1.294125629, 1.293941609, 1.293762898, 1.293589269, 1.293420507, 1.293256413, 1.293096793, 1.292941469, 1.292790268, 1.292643029, 1.292499597, 1.292359828, 1.292223583, 1.29209073, 1.291961144, 1.291834705, 1.291711301, 1.291590824, 1.291473171, 1.291358243, 1.291245948, 1.291136195, 1.291028899, 1.290923979, 1.290821356, 1.290720956, 1.290622708, 1.290526543, 1.290432395, 1.290340202, 1.290249904, 1.290161442, 1.290074761, 1.289989809, 1.289906533, 1.289824884, 1.289744816, 1.289666283, 1.289589241, 1.289513648, 1.289439464, 1.289366649, 1.289295166, 1.289224979, 1.289156054, 1.289088355, 1.289021851, 1.28895651, 1.288892302, 1.288829199, 1.288767171, 1.288706191, 1.288646234, 1.288587273, 1.288529284, 1.288472243, 1.288416127, 1.288360913, 1.288306581, 1.288253109, 1.288200477, 1.288148665, 1.288097654, 1.288047427, 1.287997964, 1.287949248, 1.287901264, 1.287853994, 1.287807422, 1.287761534, 1.287716314, 1.287671748, 1.287627821, 1.287584521, 1.287541833, 1.287499745, 1.287458245, 1.287417319, 1.287376957, 1.287337146, 1.287297876, 1.287259135, 1.287220914, 1.2871832, 1.287145985, 1.287109259, 1.287073012, 1.287037235, 1.287001918, 1.286967053, 1.286932631, 1.286898644, 1.286865084, 1.286831942, 1.286799212, 1.286766884, 1.286734952, 1.286703409, 1.286672248, 1.286641461, 1.286611042, 1.286580985, 1.286551283, 1.286521929, 1.286492918, 1.286464244, 1.286435901, 1.286407882, 1.286380184, 1.286352799, 1.286325724, 1.286298952, 1.286272479, 1.286246299, 1.286220408, 1.286194801, 1.286169474, 1.286144421, 1.286119638, 1.286095122, 1.286070867, 1.28604687, 1.286023127, 1.285999633, 1.285976384, 1.285953377, 1.285930609, 1.285908074, 1.285885771, 1.285863694, 1.285841842, 1.285820209, 1.285798794 };
+	private static readonly double[] T_Table_15 = { 4.16529977, 2.281930588, 1.924319657, 1.778192164, 1.699362566, 1.650173154, 1.616591737, 1.59222144, 1.573735785, 1.559235933, 1.547559766, 1.537956495, 1.529919606, 1.523095061, 1.517227969, 1.51213017, 1.507659754, 1.503707672, 1.500188756, 1.497035518, 1.494193795, 1.491619612, 1.489276897, 1.487135783, 1.485171326, 1.483362535, 1.481691617, 1.48014339, 1.478704821, 1.477364662, 1.47611315, 1.474941772, 1.473843072, 1.47281049, 1.471838233, 1.470921166, 1.470054719, 1.469234815, 1.468457801, 1.467720399, 1.467019655, 1.466352901, 1.465717725, 1.465111933, 1.464533534, 1.463980712, 1.463451805, 1.462945295, 1.46245979, 1.461994009, 1.461546775, 1.461117, 1.460703683, 1.460305896, 1.45992278, 1.459553538, 1.45919743, 1.458853767, 1.458521908, 1.458201256, 1.457891251, 1.457591373, 1.457301133, 1.457020074, 1.456747768, 1.45648381, 1.456227824, 1.455979454, 1.455738365, 1.455504241, 1.455276784, 1.455055715, 1.454840767, 1.45463169, 1.454428246, 1.454230212, 1.454037373, 1.453849529, 1.453666487, 1.453488066, 1.453314093, 1.453144404, 1.452978842, 1.452817259, 1.452659513, 1.452505469, 1.452354998, 1.452207977, 1.452064289, 1.451923821, 1.451786468, 1.451652126, 1.451520697, 1.451392088, 1.451266209, 1.451142973, 1.451022299, 1.450904108, 1.450788323, 1.450674871, 1.450563684, 1.450454694, 1.450347836, 1.450243048, 1.450140271, 1.450039448, 1.449940523, 1.449843444, 1.449748158, 1.449654617, 1.449562773, 1.449472581, 1.449383997, 1.449296977, 1.449211481, 1.449127468, 1.449044902, 1.448963744, 1.448883959, 1.448805513, 1.448728372, 1.448652503, 1.448577876, 1.44850446, 1.448432226, 1.448361146, 1.448291192, 1.448222337, 1.448154557, 1.448087826, 1.44802212, 1.447957415, 1.447893688, 1.447830919, 1.447769085, 1.447708165, 1.44764814, 1.44758899, 1.447530695, 1.447473238, 1.447416601, 1.447360765, 1.447305715, 1.447251433, 1.447197905, 1.447145113, 1.447093044, 1.447041682, 1.446991013, 1.446941023, 1.446891698, 1.446843026, 1.446794994, 1.446747588, 1.446700797, 1.446654609, 1.446609012, 1.446563996, 1.446519548, 1.446475659, 1.446432318, 1.446389514, 1.446347238, 1.44630548, 1.44626423, 1.44622348, 1.44618322, 1.446143442, 1.446104137, 1.446065296, 1.446026911, 1.445988975, 1.44595148, 1.445914417, 1.44587778, 1.445841561, 1.445805753, 1.445770349, 1.445735343, 1.445700727, 1.445666495, 1.445632641, 1.445599159, 1.445566042, 1.445533284, 1.445500881, 1.445468825, 1.445437112, 1.445405736, 1.445374691, 1.445343973, 1.445313576, 1.445283495, 1.445253726, 1.445224264, 1.445195103, 1.445166239, 1.445137668, 1.445109385, 1.445081387 };
+	private static readonly double[] T_Table_10 = { 6.313751515, 2.91998558, 2.353363435, 2.131846786, 2.015048373, 1.943180281, 1.894578605, 1.859548038, 1.833112933, 1.812461123, 1.795884819, 1.782287556, 1.770933396, 1.761310136, 1.753050356, 1.745883676, 1.739606726, 1.734063607, 1.729132812, 1.724718243, 1.720742903, 1.717144374, 1.713871528, 1.71088208, 1.708140761, 1.70561792, 1.703288446, 1.701130934, 1.699127027, 1.697260887, 1.695518783, 1.693888748, 1.692360309, 1.690924255, 1.689572458, 1.688297714, 1.68709362, 1.68595446, 1.684875122, 1.683851013, 1.682878002, 1.681952357, 1.681070703, 1.680229977, 1.679427393, 1.678660414, 1.677926722, 1.677224196, 1.676550893, 1.675905025, 1.67528495, 1.674689154, 1.674116237, 1.673564906, 1.673033965, 1.672522303, 1.672028888, 1.671552762, 1.671093032, 1.670648865, 1.670219484, 1.669804163, 1.669402222, 1.669013025, 1.668635976, 1.668270514, 1.667916114, 1.667572281, 1.667238549, 1.666914479, 1.666599658, 1.666293696, 1.665996224, 1.665706893, 1.665425373, 1.665151353, 1.664884537, 1.664624645, 1.664371409, 1.664124579, 1.663883913, 1.663649184, 1.663420175, 1.663196679, 1.6629785, 1.662765449, 1.662557349, 1.662354029, 1.662155326, 1.661961084, 1.661771155, 1.661585397, 1.661403674, 1.661225855, 1.661051817, 1.66088144, 1.66071461, 1.660551217, 1.660391156, 1.660234326, 1.66008063, 1.659929976, 1.659782273, 1.659637437, 1.659495383, 1.659356034, 1.659219312, 1.659085144, 1.658953458, 1.658824187, 1.658697265, 1.658572629, 1.658450216, 1.658329969, 1.65821183, 1.658095744, 1.657981659, 1.657869522, 1.657759285, 1.657650899, 1.657544319, 1.657439499, 1.657336397, 1.65723497, 1.657135178, 1.657036982, 1.656940344, 1.656845226, 1.656751594, 1.656659413, 1.656568649, 1.65647927, 1.656391244, 1.656304542, 1.656219133, 1.656134988, 1.65605208, 1.655970382, 1.655889868, 1.655810511, 1.655732287, 1.655655173, 1.655579143, 1.655504177, 1.655430251, 1.655357345, 1.655285437, 1.655214506, 1.655144534, 1.6550755, 1.655007387, 1.654940175, 1.654873847, 1.654808385, 1.654743774, 1.654679996, 1.654617035, 1.654554875, 1.654493503, 1.654432901, 1.654373057, 1.654313957, 1.654255585, 1.654197929, 1.654140976, 1.654084713, 1.654029128, 1.653974208, 1.653919942, 1.653866317, 1.653813324, 1.653760949, 1.653709184, 1.653658017, 1.653607437, 1.653557435, 1.653508002, 1.653459126, 1.6534108, 1.653363013, 1.653315758, 1.653269024, 1.653222803, 1.653177088, 1.653131869, 1.653087138, 1.653042889, 1.652999113, 1.652955802, 1.652912949, 1.652870547, 1.652828589, 1.652787068, 1.652745977, 1.65270531, 1.652665059, 1.652625219, 1.652585784, 1.652546746, 1.652508101 };
+	private static readonly double[] T_Table_05 = { 12.70620474, 4.30265273, 3.182446305, 2.776445105, 2.570581836, 2.446911851, 2.364624252, 2.306004135, 2.262157163, 2.228138852, 2.20098516, 2.17881283, 2.160368656, 2.144786688, 2.131449546, 2.119905299, 2.109815578, 2.10092204, 2.093024054, 2.085963447, 2.079613845, 2.073873068, 2.06865761, 2.063898562, 2.059538553, 2.055529439, 2.051830516, 2.048407142, 2.045229642, 2.042272456, 2.039513446, 2.036933343, 2.034515297, 2.032244509, 2.030107928, 2.028094001, 2.026192463, 2.024394164, 2.02269092, 2.02107539, 2.01954097, 2.018081703, 2.016692199, 2.015367574, 2.014103389, 2.012895599, 2.011740514, 2.010634758, 2.009575237, 2.008559112, 2.00758377, 2.006646805, 2.005745995, 2.004879288, 2.004044783, 2.003240719, 2.002465459, 2.001717484, 2.000995378, 2.000297822, 1.999623585, 1.998971517, 1.998340543, 1.997729654, 1.997137908, 1.996564419, 1.996008354, 1.995468931, 1.994945415, 1.994437112, 1.993943368, 1.993463567, 1.992997126, 1.992543495, 1.992102154, 1.99167261, 1.991254395, 1.990847069, 1.99045021, 1.990063421, 1.989686323, 1.989318557, 1.98895978, 1.988609667, 1.988267907, 1.987934206, 1.987608282, 1.987289865, 1.9869787, 1.986674541, 1.986377154, 1.986086317, 1.985801814, 1.985523442, 1.985251004, 1.984984312, 1.984723186, 1.984467455, 1.984216952, 1.983971519, 1.983731003, 1.983495259, 1.983264145, 1.983037526, 1.982815274, 1.982597262, 1.98238337, 1.982173483, 1.98196749, 1.981765282, 1.981566757, 1.981371815, 1.981180359, 1.980992298, 1.980807541, 1.980626002, 1.980447599, 1.980272249, 1.980099876, 1.979930405, 1.979763763, 1.979599878, 1.979438685, 1.979280117, 1.979124109, 1.978970602, 1.978819535, 1.97867085, 1.978524491, 1.978380405, 1.978238539, 1.978098842, 1.977961264, 1.977825758, 1.977692277, 1.977560777, 1.977431212, 1.977303542, 1.977177724, 1.97705372, 1.976931489, 1.976810994, 1.976692198, 1.976575066, 1.976459563, 1.976345655, 1.976233309, 1.976122494, 1.976013178, 1.975905331, 1.975798924, 1.975693928, 1.975590315, 1.975488058, 1.975387131, 1.975287508, 1.975189163, 1.975092073, 1.974996213, 1.97490156, 1.974808092, 1.974715786, 1.974624621, 1.974534576, 1.97444563, 1.974357764, 1.974270957, 1.974185191, 1.974100447, 1.974016708, 1.973933954, 1.973852169, 1.973771337, 1.97369144, 1.973612462, 1.973534388, 1.973457202, 1.973380889, 1.973305434, 1.973230823, 1.973157042, 1.973084077, 1.973011915, 1.972940542, 1.972869946, 1.972800114, 1.972731033, 1.972662692, 1.972595079, 1.972528182, 1.97246199, 1.972396491, 1.972331676, 1.972267533, 1.972204051, 1.972141222, 1.972079034, 1.972017478, 1.971956544, 1.971896224 };
+	private static readonly double[] T_Table_01 = { 63.65674116, 9.924843201, 5.84090931, 4.604094871, 4.032142984, 3.707428021, 3.499483297, 3.355387331, 3.249835542, 3.169272673, 3.105806516, 3.054539589, 3.012275839, 2.976842734, 2.946712883, 2.920781622, 2.89823052, 2.878440473, 2.860934606, 2.84533971, 2.831359558, 2.818756061, 2.807335684, 2.796939505, 2.787435814, 2.778714533, 2.770682957, 2.763262455, 2.756385904, 2.749995654, 2.744041919, 2.738481482, 2.733276642, 2.728394367, 2.723805589, 2.71948463, 2.715408722, 2.711557602, 2.707913184, 2.704459267, 2.701181304, 2.698066186, 2.695102079, 2.692278266, 2.689585019, 2.687013492, 2.684555618, 2.682204027, 2.679951974, 2.677793271, 2.675722234, 2.673733631, 2.671822636, 2.669984796, 2.668215988, 2.666512398, 2.664870482, 2.663286954, 2.661758752, 2.660283029, 2.658857127, 2.657478565, 2.656145025, 2.654854337, 2.653604469, 2.652393515, 2.651219685, 2.650081299, 2.648976774, 2.647904624, 2.646863444, 2.645851913, 2.644868782, 2.643912872, 2.642983067, 2.642078313, 2.641197611, 2.640340015, 2.639504627, 2.638690596, 2.637897113, 2.63712341, 2.636368757, 2.635632458, 2.634913852, 2.634212309, 2.633527229, 2.632858038, 2.632204191, 2.631565166, 2.630940463, 2.630329608, 2.629732145, 2.629147638, 2.628575671, 2.628015844, 2.627467774, 2.626931096, 2.626405457, 2.625890521, 2.625385965, 2.624891476, 2.624406758, 2.623931523, 2.623465496, 2.623008411, 2.622560015, 2.622120061, 2.621688313, 2.621264543, 2.620848534, 2.620440073, 2.620038957, 2.619644989, 2.619257981, 2.618877749, 2.618504116, 2.618136914, 2.617775976, 2.617421145, 2.617072266, 2.616729191, 2.616391776, 2.616059883, 2.615733377, 2.615412127, 2.615096008, 2.614784899, 2.61447868, 2.614177238, 2.613880461, 2.613588242, 2.613300477, 2.613017065, 2.612737908, 2.61246291, 2.61219198, 2.611925028, 2.611661966, 2.611402711, 2.611147181, 2.610895295, 2.610646976, 2.61040215, 2.610160742, 2.609922682, 2.609687901, 2.609456331, 2.609227907, 2.609002566, 2.608780245, 2.608560883, 2.608344423, 2.608130807, 2.60791998, 2.607711886, 2.607506474, 2.607303692, 2.607103489, 2.606905817, 2.606710628, 2.606517876, 2.606327515, 2.606139501, 2.605953791, 2.605770342, 2.605589114, 2.605410067, 2.605233162, 2.605058359, 2.604885623, 2.604714916, 2.604546204, 2.60437945, 2.604214622, 2.604051686, 2.60389061, 2.603731363, 2.603573912, 2.603418229, 2.603264282, 2.603112045, 2.602961487, 2.602812582, 2.602665303, 2.602519622, 2.602375515, 2.602232955, 2.602091918, 2.60195238, 2.601814317, 2.601677705, 2.601542523, 2.601408747, 2.601276355, 2.601145327, 2.601015642, 2.600887278, 2.600760216, 2.600634436 };
 }
 
 public enum Significance
@@ -125,7 +125,7 @@ public class AverageSpeed
 
 		var time = now - start;
 
-		while (speeds.Count > MAX_SPEEDS || (speeds.Count > 2 && time - speeds.First.Value.Time > SlowWindow))
+		while (speeds.Count > MAX_SPEEDS || (speeds.Count > 2 && time - speeds.First!.Value.Time > SlowWindow))
 			speeds.RemoveFirst();
 
 		if (!double.IsNaN(lastPosition))
@@ -145,7 +145,7 @@ public class AverageSpeed
 		if (speeds.Count == 0)
 			return 0;
 		else if (speeds.Count == 1)
-			return speeds.Last.Value.Velocity;
+			return speeds.Last!.Value.Velocity;
 		else
 		{
 			var n_newest = speeds.Count(s => s.Time > lastTime.Subtract(FastWindow));

Source/AaxDecrypter/Cue.cs

@@ -1,60 +1,59 @@
-using AAXClean;
-using Dinah.Core;
+using Dinah.Core;
+using Mpeg4Lib;
 using System.IO;
 using System.Text;
 
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public static class Cue
 {
-    public static class Cue
-    {
-        public static string CreateContents(string filePath, ChapterInfo chapters)
-        {
-            var stringBuilder = new StringBuilder();
+	public static string CreateContents(string filePath, ChapterInfo chapters)
+	{
+		var stringBuilder = new StringBuilder();
 
-            stringBuilder.AppendLine(GetFileLine(filePath, "MP3"));
+		stringBuilder.AppendLine(GetFileLine(filePath, "MP3"));
 
-            var startOffset = chapters.StartOffset;
+		var startOffset = chapters.StartOffset;
 
-            var trackCount = 1;
-            foreach (var c in chapters.Chapters)
-            {
-                var startTime = c.StartOffset - startOffset;
+		var trackCount = 1;
+		foreach (var c in chapters.Chapters)
+		{
+			var startTime = c.StartOffset - startOffset;
 
-                stringBuilder.AppendLine($"TRACK {trackCount++} AUDIO");
-                stringBuilder.AppendLine($"  TITLE \"{c.Title}\"");
-                stringBuilder.AppendLine($"  INDEX 01 {(int)startTime.TotalMinutes}:{startTime:ss}:{(int)(startTime.Milliseconds * 75d / 1000):D2}");
-            }
+			stringBuilder.AppendLine($"TRACK {trackCount++} AUDIO");
+			stringBuilder.AppendLine($"  TITLE \"{c.Title}\"");
+			stringBuilder.AppendLine($"  INDEX 01 {(int)startTime.TotalMinutes}:{startTime:ss}:{(int)(startTime.Milliseconds * 75d / 1000):D2}");
+		}
 
-            return stringBuilder.ToString();
-        }
+		return stringBuilder.ToString();
+	}
 
-        public static void UpdateFileName(FileInfo cueFileInfo, string audioFilePath)
-            => UpdateFileName(cueFileInfo.FullName, audioFilePath);
+	public static void UpdateFileName(FileInfo cueFileInfo, string audioFilePath)
+		=> UpdateFileName(cueFileInfo.FullName, audioFilePath);
 
-        public static void UpdateFileName(string cueFilePath, FileInfo audioFileInfo)
-            => UpdateFileName(cueFilePath, audioFileInfo.FullName);
+	public static void UpdateFileName(string cueFilePath, FileInfo audioFileInfo)
+		=> UpdateFileName(cueFilePath, audioFileInfo.FullName);
 
-        public static void UpdateFileName(FileInfo cueFileInfo, FileInfo audioFileInfo)
-            => UpdateFileName(cueFileInfo.FullName, audioFileInfo.FullName);
+	public static void UpdateFileName(FileInfo cueFileInfo, FileInfo audioFileInfo)
+		=> UpdateFileName(cueFileInfo.FullName, audioFileInfo.FullName);
 
-        public static void UpdateFileName(string cueFilePath, string audioFilePath)
-        {
-            var cueContents = File.ReadAllLines(cueFilePath);
+	public static void UpdateFileName(string cueFilePath, string audioFilePath)
+	{
+		var cueContents = File.ReadAllLines(cueFilePath);
 
-            for (var i = 0; i < cueContents.Length; i++)
-            {
-                var line = cueContents[i];
-                if (!line.Trim().StartsWith("FILE") || !line.Contains(' '))
-                    continue;
+		for (var i = 0; i < cueContents.Length; i++)
+		{
+			var line = cueContents[i];
+			if (!line.Trim().StartsWith("FILE") || !line.Contains(' '))
+				continue;
 
-                var fileTypeBegins = line.LastIndexOf(" ") + 1;
-                cueContents[i] = GetFileLine(audioFilePath, line[fileTypeBegins..]);
-                break;
-            }
+			var fileTypeBegins = line.LastIndexOf(" ") + 1;
+			cueContents[i] = GetFileLine(audioFilePath, line[fileTypeBegins..]);
+			break;
+		}
 
-            File.WriteAllLines(cueFilePath, cueContents);
-        }
+		File.WriteAllLines(cueFilePath, cueContents);
+	}
 
-        private static string GetFileLine(string filePath, string audioType) => $"FILE {Path.GetFileName(filePath).SurroundWithQuotes()} {audioType}";
-    }
+	private static string GetFileLine(string filePath, string audioType) => $"FILE {Path.GetFileName(filePath).SurroundWithQuotes()} {audioType}";
 }

Source/AaxDecrypter/IDownloadOptions.cs

@@ -1,55 +1,54 @@
 using AAXClean;
+using Mpeg4Lib;
 using System;
 
-#nullable enable
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public class KeyData
 {
-    public class KeyData
-    {
-        public byte[] KeyPart1 { get; }
-        public byte[]? KeyPart2 { get; }
+	public byte[] KeyPart1 { get; }
+	public byte[]? KeyPart2 { get; }
 
-        public KeyData(byte[] keyPart1, byte[]? keyPart2 = null)
-        {
-            KeyPart1 = keyPart1;
-            KeyPart2 = keyPart2;
-        }
+	public KeyData(byte[] keyPart1, byte[]? keyPart2 = null)
+	{
+		KeyPart1 = keyPart1;
+		KeyPart2 = keyPart2;
+	}
 
-        [Newtonsoft.Json.JsonConstructor]
-        public KeyData(string keyPart1, string? keyPart2 = null)
-        {
-            ArgumentNullException.ThrowIfNull(keyPart1, nameof(keyPart1));
-            KeyPart1 = Convert.FromHexString(keyPart1);
-            if (keyPart2 != null)
-                KeyPart2 = Convert.FromHexString(keyPart2);
-        }
-	}    
-
-	public interface IDownloadOptions
-    {
-        event EventHandler<long> DownloadSpeedChanged;
-        string DownloadUrl { get; }
-        string UserAgent { get; }
-		KeyData[]? DecryptionKeys { get; }
-        TimeSpan RuntimeLength { get; }
-        OutputFormat OutputFormat { get; }
-        bool StripUnabridged { get; }
-        bool CreateCueSheet { get; }
-        long DownloadSpeedBps { get; }
-        ChapterInfo ChapterInfo { get; }
-        bool FixupFile { get; }
-		string? AudibleProductId { get; }
-		string? Title { get; }
-		string? Subtitle { get; }
-		string? Publisher { get; }
-		string? Language { get; }
-		string? SeriesName { get; }
-		string? SeriesNumber { get; }
-		NAudio.Lame.LameConfig? LameConfig { get; }
-        bool Downsample { get; }
-        bool MatchSourceBitrate { get; }
-        bool MoveMoovToBeginning { get; }
-        string GetMultipartTitle(MultiConvertFileProperties props);
-        public FileType? InputType { get; }
-    }
+	[Newtonsoft.Json.JsonConstructor]
+	public KeyData(string keyPart1, string? keyPart2 = null)
+	{
+		ArgumentNullException.ThrowIfNull(keyPart1, nameof(keyPart1));
+		KeyPart1 = Convert.FromHexString(keyPart1);
+		if (keyPart2 != null)
+			KeyPart2 = Convert.FromHexString(keyPart2);
+	}
+}
+
+public interface IDownloadOptions
+{
+	event EventHandler<long> DownloadSpeedChanged;
+	string DownloadUrl { get; }
+	string UserAgent { get; }
+	KeyData[]? DecryptionKeys { get; }
+	TimeSpan RuntimeLength { get; }
+	OutputFormat OutputFormat { get; }
+	bool StripUnabridged { get; }
+	bool CreateCueSheet { get; }
+	long DownloadSpeedBps { get; }
+	ChapterInfo ChapterInfo { get; }
+	bool FixupFile { get; }
+	string? AudibleProductId { get; }
+	string? Title { get; }
+	string? Subtitle { get; }
+	string? Publisher { get; }
+	string? Language { get; }
+	string? SeriesName { get; }
+	string? SeriesNumber { get; }
+	NAudio.Lame.LameConfig? LameConfig { get; }
+	bool Downsample { get; }
+	bool MatchSourceBitrate { get; }
+	bool MoveMoovToBeginning { get; }
+	string GetMultipartTitle(MultiConvertFileProperties props);
+	public FileType? InputType { get; }
 }

Source/AaxDecrypter/MpegUtil.cs

@@ -1,69 +1,71 @@
-using AAXClean;
-using AAXClean.Codecs;
+using AAXClean.Codecs;
+using Mpeg4Lib;
 using NAudio.Lame;
 using System;
+using System.Linq;
 
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public static class MpegUtil
 {
-	public static class MpegUtil
+	private const string TagDomain = "com.pilabor.tone";
+	public static void ConfigureLameOptions(
+		Mpeg4File mp4File,
+		LameConfig lameConfig,
+		bool downsample,
+		bool matchSourceBitrate,
+		ChapterInfo? chapters)
 	{
-		private const string TagDomain = "com.pilabor.tone";
-		public static void ConfigureLameOptions(
-			Mp4File mp4File,
-			LameConfig lameConfig,
-			bool downsample,
-			bool matchSourceBitrate,
-			ChapterInfo chapters)
+		double bitrateMultiple = 1;
+
+		if (mp4File.TimeScale < lameConfig.OutputSampleRate)
 		{
-			double bitrateMultiple = 1;
+			lameConfig.OutputSampleRate = mp4File.TimeScale;
+		}
+		else if (mp4File.TimeScale > lameConfig.OutputSampleRate)
+		{
+			bitrateMultiple *= (double)lameConfig.OutputSampleRate / mp4File.TimeScale;
+		}
 
-			if (mp4File.TimeScale < lameConfig.OutputSampleRate)
-			{
-				lameConfig.OutputSampleRate = mp4File.TimeScale;
-			}
-			else if (mp4File.TimeScale > lameConfig.OutputSampleRate)
-			{
-				bitrateMultiple *= (double)lameConfig.OutputSampleRate / mp4File.TimeScale;
-			}
+		if (mp4File.AudioChannels == 2)
+		{
+			if (downsample)
+				bitrateMultiple /= 2;
+			else
+				lameConfig.Mode = MPEGMode.Stereo;
+		}
 
-			if (mp4File.AudioChannels == 2)
-			{
-				if (downsample)
-					bitrateMultiple /= 2;
-				else
-					lameConfig.Mode = MPEGMode.Stereo;
-			}
+		if (matchSourceBitrate)
+		{
+			int kbps = (int)Math.Round(mp4File.AverageBitrate * bitrateMultiple / 1024);
 
-			if (matchSourceBitrate)
-			{
-				int kbps = (int)Math.Round(mp4File.AverageBitrate * bitrateMultiple / 1024);
+			if (lameConfig.VBR is null)
+				lameConfig.BitRate = kbps;
+			else if (lameConfig.VBR == VBRMode.ABR)
+				lameConfig.ABRRateKbps = kbps;
+		}
 
-				if (lameConfig.VBR is null)
-					lameConfig.BitRate = kbps;
-				else if (lameConfig.VBR == VBRMode.ABR)
-					lameConfig.ABRRateKbps = kbps;
-			}
+		//Setup metadata tags
+		lameConfig.ID3 = mp4File.MetadataItems.ToIDTags();
 
-			//Setup metadata tags
-			lameConfig.ID3 = mp4File.AppleTags.ToIDTags();
+		if (mp4File.MetadataItems.AppleListBox.GetFreeformTagString(TagDomain, "SUBTITLE") is string subtitle)
+			lameConfig.ID3.Subtitle = subtitle;
 
-			if (mp4File.AppleTags.AppleListBox.GetFreeformTagString(TagDomain, "SUBTITLE") is string subtitle)
-				lameConfig.ID3.Subtitle = subtitle;
+		if (chapters?.Count > 0)
+		{
+			var cue = Cue.CreateContents(lameConfig.ID3.Title + ".mp3", chapters);
+			lameConfig.ID3.UserDefinedText.Add("CUESHEET", cue);
+		}
 
-			if (mp4File.AppleTags.AppleListBox.GetFreeformTagString(TagDomain, "LANGUAGE") is string lang)
-				lameConfig.ID3.UserDefinedText.Add("LANGUAGE", lang);
-
-			if (mp4File.AppleTags.AppleListBox.GetFreeformTagString(TagDomain, "SERIES") is string series)
-				lameConfig.ID3.UserDefinedText.Add("SERIES", series);
-
-			if (mp4File.AppleTags.AppleListBox.GetFreeformTagString(TagDomain, "PART") is string part)
-				lameConfig.ID3.UserDefinedText.Add("PART", part);
-
-			if (chapters?.Count > 0)
-			{
-				var cue = Cue.CreateContents(lameConfig.ID3.Title + ".mp3", chapters);
-				lameConfig.ID3.UserDefinedText.Add("CUESHEET", cue);
-			}
+		//Copy over all other freeform tags
+		foreach (var t in mp4File.MetadataItems.AppleListBox.Tags.OfType<Mpeg4Lib.Boxes.FreeformTagBox>())
+		{
+			if (t.Name?.Name is string name &&
+				t.Mean?.ReverseDnsDomain is string domain &&
+				!lameConfig.ID3.UserDefinedText.ContainsKey(name) &&
+				mp4File.MetadataItems.AppleListBox.GetFreeformTagString(domain, name) is string tagStr &&
+				!string.IsNullOrWhiteSpace(tagStr))
+				lameConfig.ID3.UserDefinedText.Add(name, tagStr);
 		}
 	}
 }

Source/AaxDecrypter/MultiConvertFileProperties.cs

@@ -1,13 +1,12 @@
 using System;
 
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+public class MultiConvertFileProperties
 {
-    public class MultiConvertFileProperties
-    {
-        public string OutputFileName { get; set; }
-        public int PartsPosition { get; set; }
-        public int PartsTotal { get; set; }
-        public string Title { get; set; }
-        public DateTime FileDate { get; } = DateTime.Now;
-    }
+	public required string OutputFileName { get; set; }
+	public int PartsPosition { get; set; }
+	public int PartsTotal { get; set; }
+	public string? Title { get; set; }
+	public DateTime FileDate { get; } = DateTime.Now;
 }

Source/AaxDecrypter/NetworkFileStream.cs

@@ -8,414 +8,419 @@ using System.Net.Http;
 using System.Threading;
 using System.Threading.Tasks;
 
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+/// <summary>A resumable, simultaneous file downloader and reader. </summary>
+public class NetworkFileStream : Stream, IUpdatable
 {
-	/// <summary>A resumable, simultaneous file downloader and reader. </summary>
-	public class NetworkFileStream : Stream, IUpdatable
+	public event EventHandler? Updated;
+
+	#region Public Properties
+
+	/// <summary> Location to save the downloaded data. </summary>
+	[JsonProperty(Required = Required.Always)]
+	public string SaveFilePath { get; }
+
+	/// <summary> Http(s) address of the file to download. </summary>
+	[JsonProperty(Required = Required.Always)]
+	public Uri Uri { get; private set; }
+
+	/// <summary> Http headers to be sent to the server with the request. </summary>
+	[JsonProperty(Required = Required.Always)]
+	public Dictionary<string, string> RequestHeaders { get; private set; }
+
+	/// <summary> The position in <see cref="SaveFilePath"/> that has been written and flushed to disk. </summary>
+	[JsonProperty(Required = Required.Always)]
+	public long WritePosition { get; private set; }
+
+	/// <summary> The total length of the <see cref="Uri"/> file to download. </summary>
+	[JsonProperty(Required = Required.Always)]
+	public long ContentLength { get; private set; }
+
+	[JsonIgnore]
+	public bool IsCancelled => _cancellationSource.IsCancellationRequested;
+
+	[JsonIgnore]
+	public Task? DownloadTask { get; private set; }
+
+	private long _speedLimit = 0;
+	/// <summary>bytes per second</summary>
+	public long SpeedLimit { get => _speedLimit; set => _speedLimit = value <= 0 ? 0 : Math.Max(value, MIN_BYTES_PER_SECOND); }
+
+	#endregion
+
+	#region Private Properties
+	private FileStream _writeFile { get; }
+	private FileStream _readFile { get; }
+	private CancellationTokenSource _cancellationSource { get; } = new();
+	private EventWaitHandle? _downloadedPiece { get; set; }
+
+	private DateTime NextUpdateTime { get; set; }
+
+	#endregion
+
+	#region Constants
+
+	//Download memory buffer size
+	private const int DOWNLOAD_BUFF_SZ = 8 * 1024;
+
+	//NetworkFileStream will flush all data in _writeFile to disk after every
+	//DATA_FLUSH_SZ bytes are written to the file stream.
+	private const int DATA_FLUSH_SZ = 1024 * 1024;
+
+	//Number of times per second the download rate is checked and throttled
+	private const int THROTTLE_FREQUENCY = 8;
+
+	//Minimum throttle rate. The minimum amount of data that can be throttled
+	//on each iteration of the download loop is DOWNLOAD_BUFF_SZ.
+	public const int MIN_BYTES_PER_SECOND = DOWNLOAD_BUFF_SZ * THROTTLE_FREQUENCY;
+
+	#endregion
+
+	#region Constructor
+
+	/// <summary> A resumable, simultaneous file downloader and reader. </summary>
+	/// <param name="saveFilePath">Path to a location on disk to save the downloaded data from <paramref name="uri"/></param>
+	/// <param name="uri">Http(s) address of the file to download.</param>
+	/// <param name="writePosition">The position in <paramref name="uri"/> to begin downloading.</param>
+	/// <param name="requestHeaders">Http headers to be sent to the server with the <see cref="HttpWebRequest"/>.</param>
+	public NetworkFileStream(string saveFilePath, Uri uri, long writePosition = 0, Dictionary<string, string>? requestHeaders = null)
 	{
-		public event EventHandler Updated;
+		SaveFilePath = ArgumentValidator.EnsureNotNullOrWhiteSpace(saveFilePath, nameof(saveFilePath));
+		Uri = ArgumentValidator.EnsureNotNull(uri, nameof(uri));
+		WritePosition = ArgumentValidator.EnsureGreaterThan(writePosition, nameof(writePosition), -1);
 
-		#region Public Properties
+		if (!Directory.Exists(Path.GetDirectoryName(saveFilePath)))
+			throw new ArgumentException($"Specified {nameof(saveFilePath)} directory \"{Path.GetDirectoryName(saveFilePath)}\" does not exist.");
 
-		/// <summary> Location to save the downloaded data. </summary>
-		[JsonProperty(Required = Required.Always)]
-		public string SaveFilePath { get; }
+		RequestHeaders = requestHeaders ?? new();
 
-		/// <summary> Http(s) address of the file to download. </summary>
-		[JsonProperty(Required = Required.Always)]
-		public Uri Uri { get; private set; }
-
-		/// <summary> Http headers to be sent to the server with the request. </summary>
-		[JsonProperty(Required = Required.Always)]
-		public Dictionary<string, string> RequestHeaders { get; private set; }
-
-		/// <summary> The position in <see cref="SaveFilePath"/> that has been written and flushed to disk. </summary>
-		[JsonProperty(Required = Required.Always)]
-		public long WritePosition { get; private set; }
-
-		/// <summary> The total length of the <see cref="Uri"/> file to download. </summary>
-		[JsonProperty(Required = Required.Always)]
-		public long ContentLength { get; private set; }
-
-		[JsonIgnore]
-		public bool IsCancelled => _cancellationSource.IsCancellationRequested;
-
-		[JsonIgnore]
-		public Task DownloadTask { get; private set; }
-
-		private long _speedLimit = 0;
-		/// <summary>bytes per second</summary>
-		public long SpeedLimit { get => _speedLimit; set => _speedLimit = value <= 0 ? 0 : Math.Max(value, MIN_BYTES_PER_SECOND); }
-
-		#endregion
-
-		#region Private Properties
-		private FileStream _writeFile { get; }
-		private FileStream _readFile { get; }
-		private CancellationTokenSource _cancellationSource { get; } = new();
-		private EventWaitHandle _downloadedPiece { get; set; }
-
-		private DateTime NextUpdateTime { get; set; }
-
-		#endregion
-
-		#region Constants
-
-		//Download memory buffer size
-		private const int DOWNLOAD_BUFF_SZ = 8 * 1024;
-
-		//NetworkFileStream will flush all data in _writeFile to disk after every
-		//DATA_FLUSH_SZ bytes are written to the file stream.
-		private const int DATA_FLUSH_SZ = 1024 * 1024;
-
-		//Number of times per second the download rate is checked and throttled
-		private const int THROTTLE_FREQUENCY = 8;
-
-		//Minimum throttle rate. The minimum amount of data that can be throttled
-		//on each iteration of the download loop is DOWNLOAD_BUFF_SZ.
-		public const int MIN_BYTES_PER_SECOND = DOWNLOAD_BUFF_SZ * THROTTLE_FREQUENCY;
-
-		#endregion
-
-		#region Constructor
-
-		/// <summary> A resumable, simultaneous file downloader and reader. </summary>
-		/// <param name="saveFilePath">Path to a location on disk to save the downloaded data from <paramref name="uri"/></param>
-		/// <param name="uri">Http(s) address of the file to download.</param>
-		/// <param name="writePosition">The position in <paramref name="uri"/> to begin downloading.</param>
-		/// <param name="requestHeaders">Http headers to be sent to the server with the <see cref="HttpWebRequest"/>.</param>
-		public NetworkFileStream(string saveFilePath, Uri uri, long writePosition = 0, Dictionary<string, string> requestHeaders = null)
+		_writeFile = new FileStream(SaveFilePath, FileMode.OpenOrCreate, FileAccess.Write, FileShare.ReadWrite)
 		{
-			SaveFilePath = ArgumentValidator.EnsureNotNullOrWhiteSpace(saveFilePath, nameof(saveFilePath));
-			Uri = ArgumentValidator.EnsureNotNull(uri, nameof(uri));
-			WritePosition = ArgumentValidator.EnsureGreaterThan(writePosition, nameof(writePosition), -1);
+			Position = WritePosition
+		};
 
-			if (!Directory.Exists(Path.GetDirectoryName(saveFilePath)))
-				throw new ArgumentException($"Specified {nameof(saveFilePath)} directory \"{Path.GetDirectoryName(saveFilePath)}\" does not exist.");
-
-			RequestHeaders = requestHeaders ?? new();
-
-			_writeFile = new FileStream(SaveFilePath, FileMode.OpenOrCreate, FileAccess.Write, FileShare.ReadWrite)
-			{
-				Position = WritePosition
-			};
-
-			if (_writeFile.Length < WritePosition)
-			{
-				_writeFile.Dispose();
-				throw new InvalidDataException($"{SaveFilePath} file length is shorter than {WritePosition}");
-			}
-
-			_readFile = new FileStream(SaveFilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
-
-			SetUriForSameFile(uri);
+		if (_writeFile.Length < WritePosition)
+		{
+			_writeFile.Dispose();
+			throw new InvalidDataException($"{SaveFilePath} file length is shorter than {WritePosition}");
 		}
 
-		#endregion
+		_readFile = new FileStream(SaveFilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
 
-		#region Downloader
+		SetUriForSameFile(uri);
+	}
 
-		/// <summary> Update the <see cref="Dinah.Core.IO.JsonFilePersister{T}"/>. </summary>
-		private void OnUpdate(bool waitForWrite = false)
+	#endregion
+
+	#region Downloader
+
+	/// <summary> Update the <see cref="Dinah.Core.IO.JsonFilePersister{T}"/>. </summary>
+	private void OnUpdate(bool waitForWrite = false)
+	{
+		try
 		{
-			try
+			if (waitForWrite || DateTime.UtcNow > NextUpdateTime)
 			{
-				if (waitForWrite || DateTime.UtcNow > NextUpdateTime)
+				Updated?.Invoke(this, EventArgs.Empty);
+				//JsonFilePersister Will not allow update intervals shorter than 100 milliseconds
+				//If an update is called less than 100 ms since the last update, persister will
+				//sleep the thread until 100 ms has elapsed.
+				NextUpdateTime = DateTime.UtcNow.AddMilliseconds(110);
+			}
+		}
+		catch (Exception ex)
+		{
+			Serilog.Log.Error(ex, "An error was encountered while saving the download progress to JSON");
+		}
+	}
+
+	/// <summary> Set a different <see cref="System.Uri"/> to the same file targeted by this instance of <see cref="NetworkFileStream"/> </summary>
+	/// <param name="uriToSameFile">New <see cref="System.Uri"/> host must match existing host.</param>
+	public void SetUriForSameFile(Uri uriToSameFile)
+	{
+		ArgumentValidator.EnsureNotNullOrWhiteSpace(uriToSameFile?.AbsoluteUri, nameof(uriToSameFile));
+
+		if (Path.GetFileName(uriToSameFile.LocalPath) != Path.GetFileName(Uri.LocalPath))
+			throw new ArgumentException($"New uri to the same file must have the same file name.");
+		if (uriToSameFile.Host != Uri.Host)
+			throw new ArgumentException($"New uri to the same file must have the same host.\r\n Old Host :{Uri.Host}\r\nNew Host: {uriToSameFile.Host}");
+		if (DownloadTask is not null)
+			throw new InvalidOperationException("Cannot change Uri after download has started.");
+
+		Uri = uriToSameFile;
+	}
+
+	/// <summary> Begins downloading <see cref="Uri"/> to <see cref="SaveFilePath"/> in a background thread. </summary>
+	/// <returns>The downloader <see cref="Task"/></returns>
+	public async Task BeginDownloadingAsync()
+	{
+		if (ContentLength != 0 && WritePosition == ContentLength)
+		{
+			DownloadTask = Task.CompletedTask;
+			return;
+		}
+
+		if (ContentLength != 0 && WritePosition > ContentLength)
+			throw new WebException($"Specified write position (0x{WritePosition:X10}) is larger than  {nameof(ContentLength)} (0x{ContentLength:X10}).");
+
+		//Initiate connection with the first request block and
+		//get the total content length before returning.
+		var client = new HttpClient();
+		var response = await RequestNextByteRangeAsync(client);
+
+		if (ContentLength != 0 && ContentLength != response.FileSize)
+			throw new WebException($"Content length of 0x{response.FileSize:X10} differs from partially downloaded content length of 0x{ContentLength:X10}");
+
+		ContentLength = response.FileSize;
+
+		_downloadedPiece = new EventWaitHandle(false, EventResetMode.AutoReset);
+		//Hand off the client and the open request to the downloader to download and write data to file.
+		DownloadTask = Task.Run(() => DownloadLoopInternal(client, response), _cancellationSource.Token);
+	}
+
+	private async Task DownloadLoopInternal(HttpClient client, BlockResponse blockResponse)
+	{
+		try
+		{
+			long startPosition = WritePosition;
+
+			while (WritePosition < ContentLength && !IsCancelled)
+			{
+				try
 				{
-					Updated?.Invoke(this, EventArgs.Empty);
-					//JsonFilePersister Will not allow update intervals shorter than 100 milliseconds
-					//If an update is called less than 100 ms since the last update, persister will
-					//sleep the thread until 100 ms has elapsed.
-					NextUpdateTime = DateTime.UtcNow.AddMilliseconds(110);
+					await DownloadToFile(blockResponse);
+				}
+				catch (HttpIOException e)
+					when (e.HttpRequestError is HttpRequestError.ResponseEnded
+							&& WritePosition != startPosition
+							&& WritePosition < ContentLength && !IsCancelled)
+				{
+					Serilog.Log.Logger.Debug($"The download connection ended before the file completed downloading all 0x{ContentLength:X10} bytes");
+
+					//the download made *some* progress since the last attempt.
+					//Try again to complete the download from where it left off.
+					//Make sure to rewind file to last flush position.
+					_writeFile.Position = startPosition = WritePosition;
+					blockResponse.Dispose();
+					blockResponse = await RequestNextByteRangeAsync(client);
+
+					Serilog.Log.Logger.Debug($"Resuming the file download starting at position 0x{WritePosition:X10}.");
 				}
 			}
-			catch (Exception ex)
-			{
-				Serilog.Log.Error(ex, "An error was encountered while saving the download progress to JSON");
-			}
 		}
-
-		/// <summary> Set a different <see cref="System.Uri"/> to the same file targeted by this instance of <see cref="NetworkFileStream"/> </summary>
-		/// <param name="uriToSameFile">New <see cref="System.Uri"/> host must match existing host.</param>
-		public void SetUriForSameFile(Uri uriToSameFile)
+		catch (Exception ex)
 		{
-			ArgumentValidator.EnsureNotNullOrWhiteSpace(uriToSameFile?.AbsoluteUri, nameof(uriToSameFile));
-
-			if (Path.GetFileName(uriToSameFile.LocalPath) != Path.GetFileName(Uri.LocalPath))
-				throw new ArgumentException($"New uri to the same file must have the same file name.");
-			if (uriToSameFile.Host != Uri.Host)
-				throw new ArgumentException($"New uri to the same file must have the same host.\r\n Old Host :{Uri.Host}\r\nNew Host: {uriToSameFile.Host}");
-			if (DownloadTask is not null)
-				throw new InvalidOperationException("Cannot change Uri after download has started.");
-
-			Uri = uriToSameFile;
+			//Don't throw from DownloadTask.
+			//This task gets awaited in Dispose() and we don't want to have an unhandled exception there.
+			Serilog.Log.Error(ex, "An error was encountered during the download process.");
 		}
-
-		/// <summary> Begins downloading <see cref="Uri"/> to <see cref="SaveFilePath"/> in a background thread. </summary>
-		/// <returns>The downloader <see cref="Task"/></returns>
-		public async Task BeginDownloadingAsync()
+		finally
 		{
-			if (ContentLength != 0 && WritePosition == ContentLength)
-			{
-				DownloadTask = Task.CompletedTask;
-				return;
-			}
-
-			if (ContentLength != 0 && WritePosition > ContentLength)
-				throw new WebException($"Specified write position (0x{WritePosition:X10}) is larger than  {nameof(ContentLength)} (0x{ContentLength:X10}).");
-
-			//Initiate connection with the first request block and
-			//get the total content length before returning.
-			var client = new HttpClient();
-			var response = await RequestNextByteRangeAsync(client);
-
-			if (ContentLength != 0 && ContentLength != response.FileSize)
-				throw new WebException($"Content length of 0x{response.FileSize:X10} differs from partially downloaded content length of 0x{ContentLength:X10}");
-			
-			ContentLength = response.FileSize;
-
-			_downloadedPiece = new EventWaitHandle(false, EventResetMode.AutoReset);
-			//Hand off the client and the open request to the downloader to download and write data to file.
-			DownloadTask = Task.Run(() => DownloadLoopInternal(client , response), _cancellationSource.Token);
+			_writeFile.Dispose();
+			blockResponse.Dispose();
+			client.Dispose();
 		}
+	}
 
-		private async Task DownloadLoopInternal(HttpClient client, BlockResponse blockResponse)
+	private async Task<BlockResponse> RequestNextByteRangeAsync(HttpClient client)
+	{
+		using var request = new HttpRequestMessage(HttpMethod.Get, Uri);
+
+		//Just in case it snuck in the saved json (Issue #1232)
+		RequestHeaders.Remove("Range");
+
+		foreach (var header in RequestHeaders)
+			request.Headers.Add(header.Key, header.Value);
+
+		request.Headers.Add("Range", $"bytes={WritePosition}-");
+
+		var response = await client.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, _cancellationSource.Token);
+
+		if (response.StatusCode != HttpStatusCode.PartialContent)
+			throw new WebException($"Server at {Uri.Host} responded with unexpected status code: {response.StatusCode}.");
+
+		var totalSize = response.Content.Headers.ContentRange?.Length ??
+			throw new WebException("The response did not contain a total content length.");
+
+		var rangeSize = response.Content.Headers.ContentLength ??
+			throw new WebException($"The response did not contain a {nameof(response.Content.Headers.ContentLength)};");
+
+		return new BlockResponse(response, rangeSize, totalSize);
+	}
+
+	private readonly record struct BlockResponse(HttpResponseMessage Response, long BlockSize, long FileSize) : IDisposable
+	{
+		public void Dispose() => Response?.Dispose();
+	}
+
+	/// <summary> Download <see cref="Uri"/> to <see cref="SaveFilePath"/>.</summary>
+	private async Task DownloadToFile(BlockResponse block)
+	{
+		var endPosition = WritePosition + block.BlockSize;
+		using var networkStream = await block.Response.Content.ReadAsStreamAsync(_cancellationSource.Token);
+
+		var downloadPosition = WritePosition;
+		var nextFlush = downloadPosition + DATA_FLUSH_SZ;
+		var buff = new byte[DOWNLOAD_BUFF_SZ];
+
+		try
 		{
-			try
+			DateTime startTime = DateTime.UtcNow;
+			long bytesReadSinceThrottle = 0;
+			int bytesRead;
+			do
 			{
-				long startPosition = WritePosition;
+				bytesRead = await networkStream.ReadAsync(buff, _cancellationSource.Token);
+				await _writeFile.WriteAsync(buff, 0, bytesRead, _cancellationSource.Token);
 
-				while (WritePosition < ContentLength && !IsCancelled)
+				downloadPosition += bytesRead;
+
+				if (downloadPosition > nextFlush)
 				{
-					try
-					{
-						await DownloadToFile(blockResponse);
-					}
-					catch (HttpIOException e)
-						when (e.HttpRequestError is HttpRequestError.ResponseEnded
-								&& WritePosition != startPosition
-								&& WritePosition < ContentLength && !IsCancelled)
-					{
-						Serilog.Log.Logger.Debug($"The download connection ended before the file completed downloading all 0x{ContentLength:X10} bytes");
-
-						//the download made *some* progress since the last attempt.
-						//Try again to complete the download from where it left off.
-						//Make sure to rewind file to last flush position.
-						_writeFile.Position = startPosition = WritePosition;
-						blockResponse.Dispose();
-						blockResponse = await RequestNextByteRangeAsync(client);
-
-						Serilog.Log.Logger.Debug($"Resuming the file download starting at position 0x{WritePosition:X10}.");
-					}
+					await _writeFile.FlushAsync(_cancellationSource.Token);
+					WritePosition = downloadPosition;
+					OnUpdate();
+					nextFlush = downloadPosition + DATA_FLUSH_SZ;
+					_downloadedPiece?.Set();
 				}
-			}
-			finally
-			{
-				_writeFile.Dispose();
-				blockResponse.Dispose();
-				client.Dispose();
-			}
-		}
 
-		private async Task<BlockResponse> RequestNextByteRangeAsync(HttpClient client)
-		{
-			using var request = new HttpRequestMessage(HttpMethod.Get, Uri);
+				#region throttle
 
-			//Just in case it snuck in the saved json (Issue #1232)
-			RequestHeaders.Remove("Range");
+				bytesReadSinceThrottle += bytesRead;
 
-			foreach (var header in RequestHeaders)
-				request.Headers.Add(header.Key, header.Value);
-
-			request.Headers.Add("Range", $"bytes={WritePosition}-");
-
-			var response = await client.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, _cancellationSource.Token);
-
-			if (response.StatusCode != HttpStatusCode.PartialContent)
-				throw new WebException($"Server at {Uri.Host} responded with unexpected status code: {response.StatusCode}.");
-
-			var totalSize = response.Content.Headers.ContentRange?.Length ??
-				throw new WebException("The response did not contain a total content length.");
-
-			var rangeSize = response.Content.Headers.ContentLength ??
-				throw new WebException($"The response did not contain a {nameof(response.Content.Headers.ContentLength)};");
-
-			return new BlockResponse(response, rangeSize, totalSize);
-		}
-
-		private readonly record struct BlockResponse(HttpResponseMessage Response, long BlockSize, long FileSize) : IDisposable
-		{
-			public void Dispose() => Response?.Dispose();
-		}
-
-		/// <summary> Download <see cref="Uri"/> to <see cref="SaveFilePath"/>.</summary>
-		private async Task DownloadToFile(BlockResponse block)
-		{
-			var endPosition = WritePosition + block.BlockSize;
-			using var networkStream = await block.Response.Content.ReadAsStreamAsync(_cancellationSource.Token);
-
-			var downloadPosition = WritePosition;
-			var nextFlush = downloadPosition + DATA_FLUSH_SZ;
-			var buff = new byte[DOWNLOAD_BUFF_SZ];
-
-			try
-			{
-				DateTime startTime = DateTime.UtcNow;
-				long bytesReadSinceThrottle = 0;
-				int bytesRead;
-				do
+				if (SpeedLimit >= MIN_BYTES_PER_SECOND && bytesReadSinceThrottle > SpeedLimit / THROTTLE_FREQUENCY)
 				{
-					bytesRead = await networkStream.ReadAsync(buff, _cancellationSource.Token);
-					await _writeFile.WriteAsync(buff, 0, bytesRead, _cancellationSource.Token);
+					var delayMS = (int)(startTime.AddSeconds(1d / THROTTLE_FREQUENCY) - DateTime.UtcNow).TotalMilliseconds;
+					if (delayMS > 0)
+						await Task.Delay(delayMS, _cancellationSource.Token);
 
-					downloadPosition += bytesRead;
+					startTime = DateTime.UtcNow;
+					bytesReadSinceThrottle = 0;
+				}
 
-					if (downloadPosition > nextFlush)
-					{
-						await _writeFile.FlushAsync(_cancellationSource.Token);
-						WritePosition = downloadPosition;
-						OnUpdate();
-						nextFlush = downloadPosition + DATA_FLUSH_SZ;
-						_downloadedPiece.Set();
-					}
+				#endregion
 
-					#region throttle
+			} while (downloadPosition < endPosition && !IsCancelled && bytesRead > 0);
 
-					bytesReadSinceThrottle += bytesRead;
+			await _writeFile.FlushAsync(_cancellationSource.Token);
+			WritePosition = downloadPosition;
 
-					if (SpeedLimit >= MIN_BYTES_PER_SECOND && bytesReadSinceThrottle > SpeedLimit / THROTTLE_FREQUENCY)
-					{
-						var delayMS = (int)(startTime.AddSeconds(1d / THROTTLE_FREQUENCY) - DateTime.UtcNow).TotalMilliseconds;
-						if (delayMS > 0)
-							await Task.Delay(delayMS, _cancellationSource.Token);
+			if (!IsCancelled && WritePosition < endPosition)
+				throw new WebException($"Downloaded size (0x{WritePosition:X10}) is less than {nameof(ContentLength)} (0x{ContentLength:X10}).");
 
-						startTime = DateTime.UtcNow;
-						bytesReadSinceThrottle = 0;
-					}
-
-					#endregion
-
-				} while (downloadPosition < endPosition && !IsCancelled && bytesRead > 0);
-
-				await _writeFile.FlushAsync(_cancellationSource.Token);
-				WritePosition = downloadPosition;
-
-				if (!IsCancelled && WritePosition < endPosition)
-					throw new WebException($"Downloaded size (0x{WritePosition:X10}) is less than {nameof(ContentLength)} (0x{ContentLength:X10}).");
-
-				if (WritePosition > endPosition)
-					throw new WebException($"Downloaded size (0x{WritePosition:X10}) is greater than {nameof(ContentLength)} (0x{ContentLength:X10}).");
-			}
-			catch (OperationCanceledException)
-			{
-				Serilog.Log.Information("Download was cancelled");
-			}
-			finally
-			{
-				_downloadedPiece.Set();
-				OnUpdate(waitForWrite: true);
-			}
+			if (WritePosition > endPosition)
+				throw new WebException($"Downloaded size (0x{WritePosition:X10}) is greater than {nameof(ContentLength)} (0x{ContentLength:X10}).");
 		}
-
-		#endregion
-
-		#region Download Stream Reader
-
-		[JsonIgnore]
-		public override bool CanRead => _readFile.CanRead;
-
-		[JsonIgnore]
-		public override bool CanSeek => _readFile.CanSeek;
-
-		[JsonIgnore]
-		public override bool CanWrite => false;
-
-		[JsonIgnore]
-		public override long Length
+		catch (OperationCanceledException)
 		{
-			get
-			{
-				if (DownloadTask is null)
-					throw new InvalidOperationException($"Background downloader must first be started by calling {nameof(BeginDownloadingAsync)}");
-				return ContentLength;
-			}
+			Serilog.Log.Information("Download was cancelled");
 		}
+		finally
+		{
+			_downloadedPiece?.Set();
+			OnUpdate(waitForWrite: true);
+		}
+	}
 
-		[JsonIgnore]
-		public override long Position { get => _readFile.Position; set => Seek(value, SeekOrigin.Begin); }
+	#endregion
 
-		[JsonIgnore]
-		public override bool CanTimeout => false;
+	#region Download Stream Reader
 
-		[JsonIgnore]
-		public override int ReadTimeout { get => base.ReadTimeout; set => base.ReadTimeout = value; }
+	[JsonIgnore]
+	public override bool CanRead => _readFile.CanRead;
 
-		[JsonIgnore]
-		public override int WriteTimeout { get => base.WriteTimeout; set => base.WriteTimeout = value; }
+	[JsonIgnore]
+	public override bool CanSeek => _readFile.CanSeek;
 
-		public override void Flush() => throw new InvalidOperationException();
-		public override void SetLength(long value) => throw new InvalidOperationException();
-		public override void Write(byte[] buffer, int offset, int count) => throw new InvalidOperationException();
+	[JsonIgnore]
+	public override bool CanWrite => false;
 
-		public override int Read(byte[] buffer, int offset, int count)
+	[JsonIgnore]
+	public override long Length
+	{
+		get
 		{
 			if (DownloadTask is null)
 				throw new InvalidOperationException($"Background downloader must first be started by calling {nameof(BeginDownloadingAsync)}");
-
-			var toRead = Math.Min(count, Length - Position);
-			WaitToPosition(Position + toRead);
-			return IsCancelled ? 0 : _readFile.Read(buffer, offset, count);
+			return ContentLength;
 		}
-
-		public override long Seek(long offset, SeekOrigin origin)
-		{
-			var newPosition = origin switch
-			{
-				SeekOrigin.Current => Position + offset,
-				SeekOrigin.End => ContentLength + offset,
-				_ => offset,
-			};
-
-			WaitToPosition(newPosition);
-			return _readFile.Position = newPosition;
-		}
-
-		/// <summary>Blocks until the file has downloaded to at least <paramref name="requiredPosition"/>, then returns. </summary>
-		/// <param name="requiredPosition">The minimum required flushed data length in <see cref="SaveFilePath"/>.</param>
-		private void WaitToPosition(long requiredPosition)
-		{
-			while (WritePosition < requiredPosition
-				&& DownloadTask?.IsCompleted is false
-				&& !IsCancelled)
-			{
-				_downloadedPiece.WaitOne(50);
-			}
-		}
-
-		private bool disposed = false;
-
-		/*
-		 * https://learn.microsoft.com/en-us/dotnet/api/system.io.stream.dispose?view=net-7.0
-		 * 
-		 * In derived classes, do not override the Close() method, instead, put all of the
-		 * Stream cleanup logic in the Dispose(Boolean) method.
-		 */
-		protected override void Dispose(bool disposing)
-		{
-			if (disposing && !Interlocked.CompareExchange(ref disposed, true, false))
-			{
-				_cancellationSource.Cancel();
-				DownloadTask?.GetAwaiter().GetResult();
-				_downloadedPiece?.Dispose();
-				_cancellationSource?.Dispose();
-				_readFile.Dispose();
-				_writeFile.Dispose();
-				OnUpdate(waitForWrite: true);
-			}
-
-			base.Dispose(disposing);
-		}
-
-		#endregion
 	}
+
+	[JsonIgnore]
+	public override long Position { get => _readFile.Position; set => Seek(value, SeekOrigin.Begin); }
+
+	[JsonIgnore]
+	public override bool CanTimeout => false;
+
+	[JsonIgnore]
+	public override int ReadTimeout { get => base.ReadTimeout; set => base.ReadTimeout = value; }
+
+	[JsonIgnore]
+	public override int WriteTimeout { get => base.WriteTimeout; set => base.WriteTimeout = value; }
+
+	public override void Flush() => throw new InvalidOperationException();
+	public override void SetLength(long value) => throw new InvalidOperationException();
+	public override void Write(byte[] buffer, int offset, int count) => throw new InvalidOperationException();
+
+	public override int Read(byte[] buffer, int offset, int count)
+	{
+		if (DownloadTask is null)
+			throw new InvalidOperationException($"Background downloader must first be started by calling {nameof(BeginDownloadingAsync)}");
+
+		var toRead = Math.Min(count, Length - Position);
+		WaitToPosition(Position + toRead);
+		return IsCancelled ? 0 : _readFile.Read(buffer, offset, count);
+	}
+
+	public override long Seek(long offset, SeekOrigin origin)
+	{
+		var newPosition = origin switch
+		{
+			SeekOrigin.Current => Position + offset,
+			SeekOrigin.End => ContentLength + offset,
+			_ => offset,
+		};
+
+		WaitToPosition(newPosition);
+		return _readFile.Position = newPosition;
+	}
+
+	/// <summary>Blocks until the file has downloaded to at least <paramref name="requiredPosition"/>, then returns. </summary>
+	/// <param name="requiredPosition">The minimum required flushed data length in <see cref="SaveFilePath"/>.</param>
+	private void WaitToPosition(long requiredPosition)
+	{
+		while (WritePosition < requiredPosition
+			&& DownloadTask?.IsCompleted is false
+			&& !IsCancelled)
+		{
+			_downloadedPiece?.WaitOne(50);
+		}
+	}
+
+	private bool disposed = false;
+
+	/*
+	 * https://learn.microsoft.com/en-us/dotnet/api/system.io.stream.dispose?view=net-7.0
+	 * 
+	 * In derived classes, do not override the Close() method, instead, put all of the
+	 * Stream cleanup logic in the Dispose(Boolean) method.
+	 */
+	protected override void Dispose(bool disposing)
+	{
+		if (disposing && !Interlocked.CompareExchange(ref disposed, true, false))
+		{
+			_cancellationSource.Cancel();
+			DownloadTask?.GetAwaiter().GetResult();
+			_downloadedPiece?.Dispose();
+			_cancellationSource?.Dispose();
+			_readFile.Dispose();
+			_writeFile.Dispose();
+			OnUpdate(waitForWrite: true);
+		}
+
+		base.Dispose(disposing);
+	}
+
+	#endregion
 }

Source/AaxDecrypter/NetworkFileStreamPersister.cs

@@ -1,25 +1,24 @@
 using Dinah.Core.IO;
 
-namespace AaxDecrypter
+namespace AaxDecrypter;
+
+internal class NetworkFileStreamPersister : JsonFilePersister<NetworkFileStream>
 {
-	internal class NetworkFileStreamPersister : JsonFilePersister<NetworkFileStream>
+	/// <summary>Alias for Target </summary>
+	public NetworkFileStream NetworkFileStream => Target;
+
+	/// <summary>uses path. create file if doesn't yet exist</summary>
+	public NetworkFileStreamPersister(NetworkFileStream networkFileStream, string path, string? jsonPath = null)
+		: base(networkFileStream, path, jsonPath) { }
+
+	/// <summary>load from existing file</summary>
+	public NetworkFileStreamPersister(string path, string? jsonPath = null)
+		: base(path, jsonPath) { }
+
+	protected override void Dispose(bool disposing)
 	{
-		/// <summary>Alias for Target </summary>
-		public NetworkFileStream NetworkFileStream => Target;
-
-		/// <summary>uses path. create file if doesn't yet exist</summary>
-		public NetworkFileStreamPersister(NetworkFileStream networkFileStream, string path, string jsonPath = null)
-			: base(networkFileStream, path, jsonPath) { }
-
-		/// <summary>load from existing file</summary>
-		public NetworkFileStreamPersister(string path, string jsonPath = null)
-			: base(path, jsonPath) { }
-
-		protected override void Dispose(bool disposing)
-		{
-			if (disposing)
-				NetworkFileStream?.Dispose();
-			base.Dispose(disposing);
-		}
+		if (disposing)
+			NetworkFileStream?.Dispose();
+		base.Dispose(disposing);
 	}
 }

Source/AaxDecrypter/TempFile.cs

@@ -1,6 +1,5 @@
 using FileManager;
 
-#nullable enable
 namespace AaxDecrypter;
 
 public record TempFile

Source/AaxDecrypter/UnencryptedAudiobookDownloader.cs

@@ -1,34 +1,33 @@
 using FileManager;
 using System.Threading.Tasks;
-#nullable enable
-namespace AaxDecrypter
+
+namespace AaxDecrypter;
+
+public class UnencryptedAudiobookDownloader : AudiobookDownloadBase
 {
-	public class UnencryptedAudiobookDownloader : AudiobookDownloadBase
+	protected override long InputFilePosition => InputFileStream.WritePosition;
+
+	public UnencryptedAudiobookDownloader(string outDirectory, string cacheDirectory, IDownloadOptions dlLic)
+		: base(outDirectory, cacheDirectory, dlLic)
 	{
-		protected override long InputFilePosition => InputFileStream.WritePosition;
+		AsyncSteps.Name = "Download Unencrypted Audiobook";
+		AsyncSteps["Step 1: Download Audiobook"] = Step_DownloadAndDecryptAudiobookAsync;
+		AsyncSteps["Step 2: Create Cue"] = Step_CreateCueAsync;
+	}
 
-		public UnencryptedAudiobookDownloader(string outDirectory, string cacheDirectory, IDownloadOptions dlLic)
-			: base(outDirectory, cacheDirectory, dlLic)
+	protected override async Task<bool> Step_DownloadAndDecryptAudiobookAsync()
+	{
+		await (InputFileStream.DownloadTask ?? Task.CompletedTask);
+
+		if (IsCanceled)
+			return false;
+		else
 		{
-			AsyncSteps.Name = "Download Unencrypted Audiobook";
-			AsyncSteps["Step 1: Download Audiobook"] = Step_DownloadAndDecryptAudiobookAsync;
-			AsyncSteps["Step 2: Create Cue"] = Step_CreateCueAsync;
-		}
-
-		protected override async Task<bool> Step_DownloadAndDecryptAudiobookAsync()
-		{
-			await InputFileStream.DownloadTask;
-
-			if (IsCanceled)
-				return false;
-			else
-			{
-				FinalizeDownload();
-				var tempFile = GetNewTempFilePath(DownloadOptions.OutputFormat.ToString());
-				FileUtility.SaferMove(InputFileStream.SaveFilePath, tempFile.FilePath);
-				OnTempFileCreated(tempFile);
-				return true;
-			}
+			FinalizeDownload();
+			var tempFile = GetNewTempFilePath(DownloadOptions.OutputFormat.ToString());
+			FileUtility.SaferMove(InputFileStream.SaveFilePath, tempFile.FilePath);
+			OnTempFileCreated(tempFile);
+			return true;
 		}
 	}
 }

Source/AppScaffolding/AppScaffolding.csproj

@@ -2,7 +2,8 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
-    <Version>12.7.2.1</Version>
+    <Version>13.4.2.1</Version>
+    <Nullable>enable</Nullable>
   </PropertyGroup>
   <ItemGroup>
     <PackageReference Include="Octokit" Version="14.0.0" />

Source/AppScaffolding/UNSAFE_MigrationHelper.cs

@@ -1,266 +1,267 @@
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-using Dinah.Core;
+using Dinah.Core;
 using LibationFileManager;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
+using System;
+using System.Collections.Generic;
+using System.IO;
 
-#nullable enable
-namespace AppScaffolding
+namespace AppScaffolding;
+
+/// <summary>
+/// 
+/// 
+///      directly manipulates settings files without going through domain logic.
+///      
+///      for migrations only. use with caution.
+/// 
+/// 
+/// </summary>
+public static class UNSAFE_MigrationHelper
 {
-	/// <summary>
-	/// 
-	/// 
-	///      directly manipulates settings files without going through domain logic.
-	///      
-	///      for migrations only. use with caution.
-	/// 
-	/// 
-	/// </summary>
-	public static class UNSAFE_MigrationHelper
+	public static string? SettingsDirectory
+		=> !APPSETTINGS_TryGet(LibationFiles.LIBATION_FILES_KEY, out var value) || value is null
+		? null
+		: value;
+
+	#region appsettings.json
+
+	public static bool APPSETTINGS_TryGet(string key, out string? value)
 	{
-		public static string? SettingsDirectory
-			=> !APPSETTINGS_TryGet(LibationFiles.LIBATION_FILES_KEY, out var value) || value is null
-			? null
-			: value;
+		bool success = false;
+		JToken? val = null;
 
-		#region appsettings.json
+		process_APPSETTINGS_Json(jObj => success = jObj.TryGetValue(key, out val), false);
 
-		public static bool APPSETTINGS_TryGet(string key, out string? value)
+		value = success ? val?.Value<string>() : null;
+		return success;
+	}
+
+	/// <summary>only insert if not exists</summary>
+	public static void APPSETTINGS_Insert(string key, string value)
+		=> process_APPSETTINGS_Json(jObj => jObj.TryAdd(key, value));
+
+	/// <summary>only update if exists</summary>
+	public static void APPSETTINGS_Update(string key, string value)
+		=> process_APPSETTINGS_Json(jObj =>
 		{
-			bool success = false;
-			JToken? val = null;
+			if (jObj.ContainsKey(key))
+				jObj[key] = value;
+		});
 
-			process_APPSETTINGS_Json(jObj => success = jObj.TryGetValue(key, out val), false);
+	/// <summary>only delete if exists</summary>
+	public static void APPSETTINGS_Delete(string key)
+		=> process_APPSETTINGS_Json(jObj =>
+		{
+			if (jObj.ContainsKey(key))
+				jObj.Remove(key);
+		});
 
-			value = success ? val?.Value<string>() : null;
-			return success;
+	/// <param name="save">True: save if contents changed. False: no not attempt save</param>
+	private static void process_APPSETTINGS_Json(Action<JObject> action, bool save = true)
+	{
+		if (Configuration.Instance.LibationFiles.AppsettingsJsonFile is not string appSettingsFile)
+			return;
+
+		var startingContents = File.ReadAllText(appSettingsFile);
+
+		JObject jObj;
+		try
+		{
+			jObj = JObject.Parse(startingContents);
+		}
+		catch
+		{
+			return;
 		}
 
-		/// <summary>only insert if not exists</summary>
-		public static void APPSETTINGS_Insert(string key, string value)
-			=> process_APPSETTINGS_Json(jObj => jObj.TryAdd(key, value));
+		action(jObj);
 
-		/// <summary>only update if exists</summary>
-		public static void APPSETTINGS_Update(string key, string value)
-			=> process_APPSETTINGS_Json(jObj => {
-				if (jObj.ContainsKey(key))
-					jObj[key] = value;
-			});
+		if (!save)
+			return;
 
-		/// <summary>only delete if exists</summary>
-		public static void APPSETTINGS_Delete(string key)
-			=> process_APPSETTINGS_Json(jObj => {
-				if (jObj.ContainsKey(key))
-					jObj.Remove(key);
-			});
+		// only save if different
+		var endingContents_indented = jObj.ToString(Formatting.Indented);
+		var endingContents_compact = jObj.ToString(Formatting.None);
+		if (startingContents.EqualsInsensitive(endingContents_indented) || startingContents.EqualsInsensitive(endingContents_compact))
+			return;
 
-		/// <param name="save">True: save if contents changed. False: no not attempt save</param>
-		private static void process_APPSETTINGS_Json(Action<JObject> action, bool save = true)
+		File.WriteAllText(Configuration.Instance.LibationFiles.AppsettingsJsonFile, endingContents_indented);
+		System.Threading.Thread.Sleep(100);
+	}
+	#endregion
+	#region Settings.json
+
+	public static string? SettingsJsonPath => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LibationFiles.SETTINGS_JSON);
+
+	public static bool Settings_TryGet(string key, out string? value)
+	{
+		bool success = false;
+		JToken? val = null;
+
+		process_SettingsJson(jObj => success = jObj.TryGetValue(key, out val), false);
+
+		value = success ? val?.Value<string>() : null;
+		return success;
+	}
+
+	public static bool Settings_JsonPathIsType(string jsonPath, JTokenType jTokenType)
+	{
+		JToken? val = null;
+
+		process_SettingsJson(jObj => val = jObj.SelectToken(jsonPath), false);
+
+		return val?.Type == jTokenType;
+	}
+
+	public static bool Settings_TryGetFromJsonPath(string jsonPath, out string? value)
+	{
+		JToken? val = null;
+
+		process_SettingsJson(jObj => val = jObj.SelectToken(jsonPath), false);
+
+		if (val?.Type == JTokenType.String)
 		{
-			if (Configuration.Instance.LibationFiles.AppsettingsJsonFile is not string appSettingsFile)
-				return;
-
-			var startingContents = File.ReadAllText(appSettingsFile);
-
-			JObject jObj;
-			try
-			{
-				jObj = JObject.Parse(startingContents);
-			}
-			catch
-			{
-				return;
-			}
-
-			action(jObj);
-
-			if (!save)
-				return;
-
-			// only save if different
-			var endingContents_indented = jObj.ToString(Formatting.Indented);
-			var endingContents_compact = jObj.ToString(Formatting.None);
-			if (startingContents.EqualsInsensitive(endingContents_indented) || startingContents.EqualsInsensitive(endingContents_compact))
-				return;
-
-			File.WriteAllText(Configuration.Instance.LibationFiles.AppsettingsJsonFile, endingContents_indented);
-			System.Threading.Thread.Sleep(100);
-		}
-		#endregion
-		#region Settings.json
-
-		public static string? SettingsJsonPath => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LibationFiles.SETTINGS_JSON);
-
-		public static bool Settings_TryGet(string key, out string? value)
-		{
-			bool success = false;
-			JToken? val = null;
-
-			process_SettingsJson(jObj => success = jObj.TryGetValue(key, out val), false);
-
-			value = success ? val?.Value<string>() : null;
-			return success;
-		}
-
-		public static bool Settings_JsonPathIsType(string jsonPath, JTokenType jTokenType)
-		{
-			JToken? val = null;
-
-			process_SettingsJson(jObj => val = jObj.SelectToken(jsonPath), false);
-
-			return val?.Type == jTokenType;
-		}
-
-		public static bool Settings_TryGetFromJsonPath(string jsonPath, out string? value)
-		{
-			JToken? val = null;
-
-			process_SettingsJson(jObj => val = jObj.SelectToken(jsonPath), false);
-
-			if (val?.Type == JTokenType.String)
-			{
-				value = val.Value<string>();
-				return true;
-			}
-			else
-			{
-				value = null;
-				return false;
-			}
-		}
-
-		public static void Settings_SetWithJsonPath(string jsonPath, string propertyName, string newValue)
-		{
-			if (!Settings_TryGetFromJsonPath($"{jsonPath}.{propertyName}", out _))
-				return;
-
-			process_SettingsJson(jObj =>
-			{
-				var token = jObj.SelectToken(jsonPath);
-				if (token is null
-				|| token is not JObject o
-				|| o[propertyName] is null)
-					return;
-
-				var oldValue = token.Value<string>(propertyName);
-				if (oldValue != newValue)
-					token[propertyName] = newValue;
-			});
-		}
-
-		public static bool Settings_TryGetArrayLength(string jsonPath, out int length)
-		{
-			length = 0;
-
-			if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
-				return false;
-
-			JArray? array = null;
-			process_SettingsJson(jObj => array = jObj.SelectToken(jsonPath) as JArray);
-
-			length = array?.Count ?? 0;
+			value = val.Value<string>();
 			return true;
 		}
-
-		public static void Settings_AddToArray(string jsonPath, string newValue)
+		else
 		{
-			if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
-				return;
-
-			process_SettingsJson(jObj =>
-			{
-				(jObj.SelectToken(jsonPath) as JArray)?.Add(newValue);
-			});
+			value = null;
+			return false;
 		}
-
-		/// <summary>Do not add if already exists</summary>
-		public static void Settings_AddUniqueToArray(string arrayPath, string newValue)
-		{
-			if (!Settings_TryGetArrayLength(arrayPath, out var qty))
-				return;
-
-			for (var i = 0; i < qty; i++)
-			{
-				var exists = Settings_TryGetFromJsonPath($"{arrayPath}[{i}]", out var value);
-				if (exists && value == newValue)
-					return;
-			}
-
-			Settings_AddToArray(arrayPath, newValue);
-		}
-
-		/// <summary>only remove if not exists</summary>
-		public static void Settings_RemoveFromArray(string jsonPath, int position)
-		{
-			if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
-				return;
-
-			process_SettingsJson(jObj =>
-			{
-				if (jObj.SelectToken(jsonPath) is JArray array && position < array.Count)
-					array.RemoveAt(position);
-			});
-		}
-
-		/// <summary>only insert if not exists</summary>
-		public static void Settings_Insert(string key, string value)
-			=> process_SettingsJson(jObj => jObj.TryAdd(key, value));
-
-		/// <summary>only update if exists</summary>
-		public static void Settings_Update(string key, string value)
-			=> process_SettingsJson(jObj => {
-				if (jObj.ContainsKey(key))
-					jObj[key] = value;
-			});
-
-		/// <summary>only delete if exists</summary>
-		public static void Settings_Delete(string key)
-			=> process_SettingsJson(jObj => {
-				if (jObj.ContainsKey(key))
-					jObj.Remove(key);
-			});
-
-		/// <param name="save">True: save if contents changed. False: no not attempt save</param>
-		private static void process_SettingsJson(Action<JObject> action, bool save = true)
-		{
-			// only insert if not exists
-			if (!File.Exists(SettingsJsonPath))
-				return;
-
-			var startingContents = File.ReadAllText(SettingsJsonPath);
-
-			JObject jObj;
-			try
-			{
-				jObj = JObject.Parse(startingContents);
-			}
-			catch
-			{
-				return;
-			}
-
-			action(jObj);
-
-			if (!save)
-				return;
-
-			// only save if different
-			var endingContents_indented = jObj.ToString(Formatting.Indented);
-			var endingContents_compact = jObj.ToString(Formatting.None);
-			if (startingContents.EqualsInsensitive(endingContents_indented) || startingContents.EqualsInsensitive(endingContents_compact))
-				return;
-
-			File.WriteAllText(SettingsJsonPath, endingContents_indented);
-			System.Threading.Thread.Sleep(100);
-		}
-		#endregion
-		#region LibationContext.db
-		public const string LIBATION_CONTEXT = "LibationContext.db";
-		public static string? DatabaseFile => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LIBATION_CONTEXT);
-		public static bool DatabaseFile_Exists => DatabaseFile is not null && File.Exists(DatabaseFile);
-		#endregion
 	}
+
+	public static void Settings_SetWithJsonPath(string jsonPath, string propertyName, string newValue)
+	{
+		if (!Settings_TryGetFromJsonPath($"{jsonPath}.{propertyName}", out _))
+			return;
+
+		process_SettingsJson(jObj =>
+		{
+			var token = jObj.SelectToken(jsonPath);
+			if (token is null
+			|| token is not JObject o
+			|| o[propertyName] is null)
+				return;
+
+			var oldValue = token.Value<string>(propertyName);
+			if (oldValue != newValue)
+				token[propertyName] = newValue;
+		});
+	}
+
+	public static bool Settings_TryGetArrayLength(string jsonPath, out int length)
+	{
+		length = 0;
+
+		if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
+			return false;
+
+		JArray? array = null;
+		process_SettingsJson(jObj => array = jObj.SelectToken(jsonPath) as JArray);
+
+		length = array?.Count ?? 0;
+		return true;
+	}
+
+	public static void Settings_AddToArray(string jsonPath, string newValue)
+	{
+		if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
+			return;
+
+		process_SettingsJson(jObj =>
+		{
+			(jObj.SelectToken(jsonPath) as JArray)?.Add(newValue);
+		});
+	}
+
+	/// <summary>Do not add if already exists</summary>
+	public static void Settings_AddUniqueToArray(string arrayPath, string newValue)
+	{
+		if (!Settings_TryGetArrayLength(arrayPath, out var qty))
+			return;
+
+		for (var i = 0; i < qty; i++)
+		{
+			var exists = Settings_TryGetFromJsonPath($"{arrayPath}[{i}]", out var value);
+			if (exists && value == newValue)
+				return;
+		}
+
+		Settings_AddToArray(arrayPath, newValue);
+	}
+
+	/// <summary>only remove if not exists</summary>
+	public static void Settings_RemoveFromArray(string jsonPath, int position)
+	{
+		if (!Settings_JsonPathIsType(jsonPath, JTokenType.Array))
+			return;
+
+		process_SettingsJson(jObj =>
+		{
+			if (jObj.SelectToken(jsonPath) is JArray array && position < array.Count)
+				array.RemoveAt(position);
+		});
+	}
+
+	/// <summary>only insert if not exists</summary>
+	public static void Settings_Insert(string key, string value)
+		=> process_SettingsJson(jObj => jObj.TryAdd(key, value));
+
+	/// <summary>only update if exists</summary>
+	public static void Settings_Update(string key, string value)
+		=> process_SettingsJson(jObj =>
+		{
+			if (jObj.ContainsKey(key))
+				jObj[key] = value;
+		});
+
+	/// <summary>only delete if exists</summary>
+	public static void Settings_Delete(string key)
+		=> process_SettingsJson(jObj =>
+		{
+			if (jObj.ContainsKey(key))
+				jObj.Remove(key);
+		});
+
+	/// <param name="save">True: save if contents changed. False: no not attempt save</param>
+	private static void process_SettingsJson(Action<JObject> action, bool save = true)
+	{
+		// only insert if not exists
+		if (!File.Exists(SettingsJsonPath))
+			return;
+
+		var startingContents = File.ReadAllText(SettingsJsonPath);
+
+		JObject jObj;
+		try
+		{
+			jObj = JObject.Parse(startingContents);
+		}
+		catch
+		{
+			return;
+		}
+
+		action(jObj);
+
+		if (!save)
+			return;
+
+		// only save if different
+		var endingContents_indented = jObj.ToString(Formatting.Indented);
+		var endingContents_compact = jObj.ToString(Formatting.None);
+		if (startingContents.EqualsInsensitive(endingContents_indented) || startingContents.EqualsInsensitive(endingContents_compact))
+			return;
+
+		File.WriteAllText(SettingsJsonPath, endingContents_indented);
+		System.Threading.Thread.Sleep(100);
+	}
+	#endregion
+	#region LibationContext.db
+	public const string LIBATION_CONTEXT = "LibationContext.db";
+	public static string? DatabaseFile => SettingsDirectory is null ? null : Path.Combine(SettingsDirectory, LIBATION_CONTEXT);
+	public static bool DatabaseFile_Exists => DatabaseFile is not null && File.Exists(DatabaseFile);
+	#endregion
 }

Source/AppScaffolding/UpgradeProperties.cs

@@ -1,26 +1,42 @@
-using System;
+using System;
 using System.Text.RegularExpressions;
 
-namespace AppScaffolding
+namespace AppScaffolding;
+
+/// <summary>Result of a version check: definitive up-to-date, update available, or unable to determine.</summary>
+public enum VersionCheckOutcome
 {
-	public partial record UpgradeProperties
-	{
-		public string ZipUrl { get; }
-		public string HtmlUrl { get; }
-		public string ZipName { get; }
-		public Version LatestRelease { get; }
-		public string Notes { get; }
-
-		public UpgradeProperties(string zipUrl, string htmlUrl, string zipName, Version latestRelease, string notes)
-		{
-			ZipName = zipName;
-			HtmlUrl = htmlUrl;
-			ZipUrl = zipUrl;
-			LatestRelease = latestRelease;
-			Notes = LinkStripRegex().Replace(notes, "$1");
-		}
-
-		[GeneratedRegex(@"\[(.*)\]\(.*\)")]
-		private static partial Regex LinkStripRegex();
-	}
+	UpToDate,
+	UpdateAvailable,
+	UnableToDetermine,
+}
+
+/// <summary>Result of checking for a new version. Use <see cref="Outcome"/> to show the right message; <see cref="UpgradeProperties"/> is set only when <see cref="Outcome"/> is <see cref="VersionCheckOutcome.UpdateAvailable"/>.</summary>
+public record VersionCheckResult(VersionCheckOutcome Outcome, UpgradeProperties? UpgradeProperties = null);
+
+public partial record UpgradeProperties
+{
+	public string ZipUrl { get; }
+	public string HtmlUrl { get; }
+	public string ZipName { get; }
+	public Version LatestRelease { get; }
+	public string Notes { get; }
+
+	public UpgradeProperties(string zipUrl, string htmlUrl, string zipName, Version latestRelease, string notes)
+	{
+		ZipName = zipName;
+		HtmlUrl = htmlUrl;
+		ZipUrl = zipUrl;
+		LatestRelease = latestRelease;
+
+		var text = NoAppBlockRegex().Replace(notes, "");
+		text = LinkStripRegex().Replace(text, "$1");
+		Notes = text.Trim();
+	}
+
+	[GeneratedRegex(@"\[(.*)\]\(.*\)")]
+	private static partial Regex LinkStripRegex();
+
+	[GeneratedRegex(@"<!-- BEGIN NO-APP -->.*?<!-- END NO-APP -->", RegexOptions.Singleline)]
+	private static partial Regex NoAppBlockRegex();
 }

Source/ApplicationServices/ApplicationServices.csproj

@@ -2,11 +2,16 @@
 
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="CsvHelper" Version="33.1.0" />
-	<PackageReference Include="ClosedXML" Version="0.105.0" />
+	<PackageReference Include="CsvHelper" Version="33.1.0">
+      <PrivateAssets>compile;contentFiles;build;buildMultitargeting;buildTransitive;analyzers;native</PrivateAssets>
+	</PackageReference>
+	<PackageReference Include="ClosedXML" Version="0.105.0">
+      <PrivateAssets>compile;contentFiles;build;buildMultitargeting;buildTransitive;analyzers;native</PrivateAssets>
+	</PackageReference>
   </ItemGroup>
 
   <ItemGroup>

Source/ApplicationServices/BulkSetDownloadStatus.cs

@@ -1,78 +1,76 @@
-using System;
+using DataLayer;
+using Dinah.Core;
+using LibationFileManager;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
-using DataLayer;
-using Dinah.Core;
-using LibationFileManager;
 
-namespace ApplicationServices
+namespace ApplicationServices;
+
+public class BulkSetDownloadStatus
 {
-    public class BulkSetDownloadStatus
-    {
-        private List<(string message, LiberatedStatus newStatus, IEnumerable<LibraryBook> LibraryBooks)> actionSets { get; } = new();
+	private List<(string message, LiberatedStatus newStatus, IEnumerable<LibraryBook> LibraryBooks)> actionSets { get; } = new();
 
-        public int Count => actionSets.Count;
+	public int Count => actionSets.Count;
 
-        public IEnumerable<string> Messages => actionSets.Select(a => a.message);
-        public string AggregateMessage => $"Are you sure you want to set {Messages.Aggregate((a, b) => $"{a} and {b}")}?";
+	public IEnumerable<string> Messages => actionSets.Select(a => a.message);
+	public string AggregateMessage => $"Are you sure you want to set {Messages.Aggregate((a, b) => $"{a} and {b}")}?";
 
-        private List<LibraryBook> _libraryBooks;
-        private bool _setDownloaded;
-        private bool _setNotDownloaded;
+	private readonly List<LibraryBook> _libraryBooks;
+	private readonly bool _setDownloaded;
+	private readonly bool _setNotDownloaded;
 
-        public BulkSetDownloadStatus(List<LibraryBook> libraryBooks, bool setDownloaded, bool setNotDownloaded)
-        {
-            _libraryBooks = libraryBooks;
-            _setDownloaded = setDownloaded;
-            _setNotDownloaded = setNotDownloaded;
-        }
+	public BulkSetDownloadStatus(List<LibraryBook> libraryBooks, bool setDownloaded, bool setNotDownloaded)
+	{
+		_libraryBooks = libraryBooks;
+		_setDownloaded = setDownloaded;
+		_setNotDownloaded = setNotDownloaded;
+	}
 
-        public int Discover()
-        {
-            var bookExistsList = _libraryBooks
-                .Select(libraryBook => new
-                {
-					LibraryBook = libraryBook,
-                    FileExists = AudibleFileStorage.Audio.GetPath(libraryBook.Book.AudibleProductId) is not null
-                })
-                .ToList();
+	public int Discover()
+	{
+		var bookExistsList = _libraryBooks
+			.Select(libraryBook => new
+			{
+				LibraryBook = libraryBook,
+				FileExists = AudibleFileStorage.Audio.GetPath(libraryBook.Book.AudibleProductId) is not null
+			})
+			.ToList();
 
-            if (_setDownloaded)
-            {
-                var books2change = bookExistsList
-                    .Where(a => a.FileExists && a.LibraryBook.Book.UserDefinedItem.BookStatus != LiberatedStatus.Liberated)
-                    .Select(a => a.LibraryBook)
-                    .ToList();
+		if (_setDownloaded)
+		{
+			var books2change = bookExistsList
+				.Where(a => a.FileExists && a.LibraryBook.Book.UserDefinedItem.BookStatus != LiberatedStatus.Liberated)
+				.Select(a => a.LibraryBook)
+				.ToList();
 
-                if (books2change.Any())
-                    actionSets.Add((
-                        $"{"book".PluralizeWithCount(books2change.Count)} to 'Downloaded'",
-                        LiberatedStatus.Liberated,
-                        books2change));
-            }
+			if (books2change.Any())
+				actionSets.Add((
+					$"{"book".PluralizeWithCount(books2change.Count)} to 'Downloaded'",
+					LiberatedStatus.Liberated,
+					books2change));
+		}
 
-            if (_setNotDownloaded)
-            {
-                var books2change = bookExistsList
-                    .Where(a => !a.FileExists && a.LibraryBook.Book.UserDefinedItem.BookStatus != LiberatedStatus.NotLiberated)
-                    .Select(a => a.LibraryBook)
-                    .ToList();
+		if (_setNotDownloaded)
+		{
+			var books2change = bookExistsList
+				.Where(a => !a.FileExists && a.LibraryBook.Book.UserDefinedItem.BookStatus != LiberatedStatus.NotLiberated)
+				.Select(a => a.LibraryBook)
+				.ToList();
 
-                if (books2change.Any())
-                    actionSets.Add((
-                        $"{"book".PluralizeWithCount(books2change.Count)} to 'Not Downloaded'",
-                        LiberatedStatus.NotLiberated,
-                        books2change));
-            }
+			if (books2change.Any())
+				actionSets.Add((
+					$"{"book".PluralizeWithCount(books2change.Count)} to 'Not Downloaded'",
+					LiberatedStatus.NotLiberated,
+					books2change));
+		}
 
-            return Count;
-        }
+		return Count;
+	}
 
-        public async Task ExecuteAsync()
-        {
-            foreach (var a in actionSets)
-                await a.LibraryBooks.UpdateBookStatusAsync(a.newStatus);
-        }
-    }
+	public async Task ExecuteAsync()
+	{
+		foreach (var a in actionSets)
+			await a.LibraryBooks.UpdateBookStatusAsync(a.newStatus);
+	}
 }

Source/ApplicationServices/DbContexts.cs

@@ -1,40 +1,140 @@
 using DataLayer;
 using LibationFileManager;
-using Microsoft.EntityFrameworkCore;
+using Serilog;
+using System;
 using System.Collections.Generic;
+using System.IO;
+using System.Threading;
 
-#nullable enable
-namespace ApplicationServices
+namespace ApplicationServices;
+
+public static class DbContexts
 {
-    public static class DbContexts
-    {
-        /// <summary>Use for fully functional context, incl. SaveChanges(). For query-only, use the other method</summary>
-        public static LibationContext GetContext()
-        {
-            var context = !string.IsNullOrEmpty(Configuration.Instance.PostgresqlConnectionString)
-                ? LibationContextFactory.CreatePostgres(Configuration.Instance.PostgresqlConnectionString)
-                : LibationContextFactory.CreateSqlite(SqliteStorage.ConnectionString);
-            context.Database.Migrate();
-            return context;
-        }
+	private static bool _sqliteDbValidated;
 
-        /// <summary>Use for full library querying. No lazy loading</summary>
-        public static List<LibraryBook> GetLibrary_Flat_NoTracking(bool includeParents = false)
-        {
-            using var context = GetContext();
-            return context.GetLibrary_Flat_NoTracking(includeParents);
-        }
+	private static readonly object _initialDatabaseStatisticsCaptureLock = new();
 
-        public static List<LibraryBook> GetDeletedLibraryBooks()
-        {
-            using var context = GetContext();
-            return context.GetDeletedLibraryBooks();
-        }
+	/// <summary>
+	/// True after initial DB statistics were read and either written to Serilog or stored for <see cref="TryEmitPendingInitialDatabaseStatistics"/>.
+	/// False if capture has not run yet or the last attempt threw (a later <see cref="GetContext"/> may retry).
+	/// </summary>
+	private static bool _initialDatabaseStatisticsCaptured;
 
-		public static LibraryBook? GetLibraryBook_Flat_NoTracking(string productId, bool caseSensative = true)
-        {
-			using var context = GetContext();
-			return context.GetLibraryBook_Flat_NoTracking(productId, caseSensative);
+	/// <summary>Shape of the initial DB statistics log event; edit here only when changing what is logged.</summary>
+	private sealed class InitialDatabaseStatistics
+	{
+		public required int LibraryBooksNotInTrash { get; init; }
+		public required int LibraryBooksInTrash { get; init; }
+		public required int BookRecords { get; init; }
+	}
+
+	private static InitialDatabaseStatistics? _pendingInitialDbStats;
+
+	/// <summary>Use for fully functional context, incl. SaveChanges(). For query-only, use the other method</summary>
+	public static LibationContext GetContext()
+	{
+		var context = !string.IsNullOrEmpty(Configuration.Instance.PostgresqlConnectionString)
+			? LibationContextFactory.CreatePostgres(Configuration.Instance.PostgresqlConnectionString)
+			: LibationContextFactory.CreateSqlite(SqliteStorage.ConnectionString);
+		try
+		{
+			LibationContextFactory.ApplyMigrations(
+				context,
+				string.IsNullOrEmpty(Configuration.Instance.PostgresqlConnectionString) ? SqliteStorage.DatabasePath : null);
+		}
+		catch (InvalidOperationException ex) when (ex.Message.Contains("Libation cannot write its SQLite database", StringComparison.Ordinal))
+		{
+			Log.Error(
+				ex,
+				"SQLite migrations failed (read-only or blocked). LibationFiles={LibationFiles} DatabasePath={DatabasePath} AppsettingsJson={AppsettingsJson}",
+				Configuration.Instance.LibationFiles.Location,
+				SqliteStorage.DatabasePath,
+				Configuration.Instance.LibationFiles.AppsettingsJsonFile ?? "(null, LIBATION_FILES_DIR may be set)");
+			throw;
+		}
+
+		// Validate SQLite DB file was created and is accessible (once per process; OS may delay availability)
+		if (!_sqliteDbValidated && string.IsNullOrEmpty(Configuration.Instance.PostgresqlConnectionString))
+		{
+			EssentialFileValidator.ValidateCreatedAndReport(SqliteStorage.DatabasePath);
+			_sqliteDbValidated = true;
+		}
+
+		TryCaptureInitialDatabaseStatistics(context);
+
+		return context;
+	}
+
+	private static void TryCaptureInitialDatabaseStatistics(LibationContext context)
+	{
+		lock (_initialDatabaseStatisticsCaptureLock)
+		{
+			if (_initialDatabaseStatisticsCaptured)
+				return;
+
+			try
+			{
+				var (notInTrash, inTrash) = context.GetLibraryBookCountsByTrashFlag();
+				var bookRecords = context.GetBookCount();
+
+				var stats = new InitialDatabaseStatistics
+				{
+					LibraryBooksNotInTrash = notInTrash,
+					LibraryBooksInTrash = inTrash,
+					BookRecords = bookRecords,
+				};
+
+				if (Configuration.Instance.SerilogInitialized)
+					LogInitialDatabaseStatistics(stats);
+				else
+					_pendingInitialDbStats = stats;
+
+				_initialDatabaseStatisticsCaptured = true;
+			}
+			catch (Exception ex)
+			{
+				if (Configuration.Instance.SerilogInitialized)
+					Log.Warning(ex, "Could not capture initial database statistics");
+			}
 		}
 	}
+
+	/// <summary>
+	/// Writes initial DB statistics that were captured before Serilog was configured (e.g. WinForms early library load).
+	/// Call once after <see cref="Configuration.ConfigureLogging"/>.
+	/// </summary>
+	public static void TryEmitPendingInitialDatabaseStatistics()
+	{
+		var pending = Interlocked.Exchange(ref _pendingInitialDbStats, null);
+		if (pending is not null)
+			LogInitialDatabaseStatistics(pending);
+	}
+
+	private static void LogInitialDatabaseStatistics(InitialDatabaseStatistics stats) =>
+		Log.Logger.Information("Initial database statistics. {@DbStats}", stats);
+
+	/// <summary>Use for full library querying. No lazy loading</summary>
+	public static List<LibraryBook> GetLibrary_Flat_NoTracking(bool includeParents = false)
+	{
+		using var context = GetContext();
+		return context.GetLibrary_Flat_NoTracking(includeParents);
+	}
+
+	public static List<LibraryBook> GetUnliberated_Flat_NoTracking()
+	{
+		using var context = GetContext();
+		return context.GetUnLiberated_Flat_NoTracking();
+	}
+
+	public static List<LibraryBook> GetDeletedLibraryBooks()
+	{
+		using var context = GetContext();
+		return context.GetDeletedLibraryBooks();
+	}
+
+	public static LibraryBook? GetLibraryBook_Flat_NoTracking(string productId, bool caseSensative = true)
+	{
+		using var context = GetContext();
+		return context.GetLibraryBook_Flat_NoTracking(productId, caseSensative);
+	}
 }

Source/ApplicationServices/ExportDto.cs

@@ -0,0 +1,141 @@
+using CsvHelper.Configuration.Attributes;
+using DataLayer;
+using Newtonsoft.Json;
+using System;
+using System.Linq;
+
+namespace ApplicationServices;
+
+internal class ExportDto(LibraryBook libBook)
+{
+	[Name("Account")]
+	public string Account { get; } = libBook.Account;
+
+	[Name("Date Added to library")]
+	public DateTime DateAdded { get; } = libBook.DateAdded;
+
+	[Name("Is Audible Plus?")]
+	public bool IsAudiblePlus { get; } = libBook.IsAudiblePlus;
+
+	[Name("Absent from last scan?")]
+	public bool AbsentFromLastScan { get; } = libBook.AbsentFromLastScan;
+
+	[Name("Audible Product Id")]
+	public string AudibleProductId { get; } = libBook.Book.AudibleProductId;
+
+	[Name("Locale")]
+	public string Locale { get; } = libBook.Book.Locale;
+
+	[Name("Title")]
+	public string Title { get; } = libBook.Book.Title;
+
+	[Name("Subtitle")]
+	public string Subtitle { get; } = libBook.Book.Subtitle;
+
+	[Name("Authors")]
+	public string AuthorNames { get; } = libBook.Book.AuthorNames;
+
+	[Name("Narrators")]
+	public string NarratorNames { get; } = libBook.Book.NarratorNames;
+
+	[Name("Length In Minutes")]
+	public int LengthInMinutes { get; } = libBook.Book.LengthInMinutes;
+
+	[Name("Description")]
+	public string Description { get; } = libBook.Book.Description;
+
+	[Name("Publisher")]
+	public string? Publisher { get; } = libBook.Book.Publisher;
+
+	[Name("Has PDF")]
+	public bool HasPdf { get; } = libBook.Book.HasPdf;
+
+	[Name("Series Names")]
+	public string SeriesNames { get; } = libBook.Book.SeriesNames();
+
+	[Name("Series Order")]
+	public string SeriesOrder { get; } = libBook.Book.SeriesLink?.Any() is true ? string.Join(", ", libBook.Book.SeriesLink.Select(sl => $"{sl.Order} : {sl.Series.Name}")) : "";
+
+	[Name("Community Rating: Overall")]
+	public float? CommunityRatingOverall { get; } = ZeroIsNull(libBook.Book.Rating?.OverallRating);
+
+	[Name("Community Rating: Performance")]
+	public float? CommunityRatingPerformance { get; } = ZeroIsNull(libBook.Book.Rating?.PerformanceRating);
+
+	[Name("Community Rating: Story")]
+	public float? CommunityRatingStory { get; } = ZeroIsNull(libBook.Book.Rating?.StoryRating);
+
+	[Name("Cover Id")]
+	public string? PictureId { get; } = libBook.Book.PictureId;
+
+	[Name("Cover Id Large")]
+	public string? PictureLarge { get; } = libBook.Book.PictureLarge;
+
+	[Name("Is Abridged?")]
+	public bool IsAbridged { get; } = libBook.Book.IsAbridged;
+
+	[Name("Date Published")]
+	public DateTime? DatePublished { get; } = libBook.Book.DatePublished;
+
+	[Name("Categories")]
+	public string CategoriesNames { get; } = string.Join("; ", libBook.Book.LowestCategoryNames());
+
+	[Name("My Rating: Overall")]
+	public float? MyRatingOverall { get; } = ZeroIsNull(libBook.Book.UserDefinedItem.Rating.OverallRating);
+
+	[Name("My Rating: Performance")]
+	public float? MyRatingPerformance { get; } = ZeroIsNull(libBook.Book.UserDefinedItem.Rating.PerformanceRating);
+
+	[Name("My Rating: Story")]
+	public float? MyRatingStory { get; } = ZeroIsNull(libBook.Book.UserDefinedItem.Rating.StoryRating);
+
+	[Name("My Libation Tags")]
+	public string MyLibationTags { get; } = libBook.Book.UserDefinedItem.Tags;
+
+	[Name("Book Liberated Status")]
+	public string BookStatus { get; } = libBook.Book.UserDefinedItem.BookStatus.ToString();
+
+	[Name("PDF Liberated Status")]
+	public string? PdfStatus { get; } = libBook.Book.UserDefinedItem.PdfStatus.ToString();
+
+	[Name("Content Type")]
+	public string ContentType { get; } = libBook.Book.ContentType.ToString();
+
+	[Name("Language")]
+	public string? Language { get; } = libBook.Book.Language;
+
+	[Name("Last Downloaded")]
+	public DateTime? LastDownloaded { get; } = libBook.Book.UserDefinedItem.LastDownloaded;
+
+	[Name("Last Downloaded Version")]
+	public string? LastDownloadedVersion { get; } = libBook.Book.UserDefinedItem.LastDownloadedVersion?.ToString();
+
+	[Name("Is Finished?")]
+	public bool IsFinished { get; } = libBook.Book.UserDefinedItem.IsFinished;
+
+	[Name("Is Spatial?")]
+	public bool IsSpatial { get; } = libBook.Book.IsSpatial;
+
+	[Name("Included Until")]
+	public DateTime? IncludedUntil { get; } = libBook.IncludedUntil;
+
+	[Name("Last Downloaded File Version")]
+	public string? LastDownloadedFileVersion { get; } = libBook.Book.UserDefinedItem.LastDownloadedFileVersion;
+
+	[Ignore /* csv ignore */]
+	public AudioFormat? LastDownloadedFormat { get; } = libBook.Book.UserDefinedItem.LastDownloadedFormat;
+
+	[Name("Last Downloaded Codec"), JsonIgnore]
+	public string CodecString => LastDownloadedFormat?.CodecString ?? "";
+
+	[Name("Last Downloaded Sample rate"), JsonIgnore]
+	public int? SampleRate => LastDownloadedFormat?.SampleRate;
+
+	[Name("Last Downloaded Audio Channels"), JsonIgnore]
+	public int? ChannelCount => LastDownloadedFormat?.ChannelCount;
+
+	[Name("Last Downloaded Bitrate"), JsonIgnore]
+	public int? BitRate => LastDownloadedFormat?.BitRate;
+
+	private static float? ZeroIsNull(float? value) => value is 0 ? null : value;
+}

Source/ApplicationServices/ISearchEngine.cs

@@ -0,0 +1,8 @@
+using LibationSearchEngine;
+
+namespace ApplicationServices;
+
+public interface ISearchEngine
+{
+	SearchResultSet? GetSearchResultSet(string? searchString);
+}

Source/ApplicationServices/LibraryExporter.cs

@@ -3,322 +3,79 @@ using CsvHelper;
 using CsvHelper.Configuration.Attributes;
 using DataLayer;
 using Newtonsoft.Json;
-using System;
 using System.Collections.Generic;
 using System.Globalization;
 using System.Linq;
+using System.Reflection;
 
-namespace ApplicationServices
+namespace ApplicationServices;
+
+public static class LibraryExporter
 {
-	public class ExportDto
+	public static void ToCsv(string saveFilePath, IEnumerable<LibraryBook>? libraryBooks = null)
 	{
-		public static string GetName(string fieldName)
-		{
-			var property = typeof(ExportDto).GetProperty(fieldName);
-			var attribute = property.GetCustomAttributes(typeof(NameAttribute), true)[0];
-			var description = (NameAttribute)attribute;
-			var text = description.Names;
-			return text[0];
-		}
+		libraryBooks ??= DbContexts.GetLibrary_Flat_NoTracking();
+		var dtos = libraryBooks.ToDtos();
+		if (dtos.Count == 0)
+			return;
 
-		[Name("Account")]
-		public string Account { get; set; }
-
-		[Name("Date Added to library")]
-		public DateTime DateAdded { get; set; }
-
-		[Name("Audible Product Id")]
-		public string AudibleProductId { get; set; }
-
-		[Name("Locale")]
-		public string Locale { get; set; }
-
-		[Name("Title")]
-		public string Title { get; set; }
-
-		[Name("Subtitle")]
-		public string Subtitle { get; set; }
-
-		[Name("Authors")]
-		public string AuthorNames { get; set; }
-
-		[Name("Narrators")]
-		public string NarratorNames { get; set; }
-
-		[Name("Length In Minutes")]
-		public int LengthInMinutes { get; set; }
-
-		[Name("Description")]
-		public string Description { get; set; }
-
-		[Name("Publisher")]
-		public string Publisher { get; set; }
-
-		[Name("Has PDF")]
-		public bool HasPdf { get; set; }
-
-		[Name("Series Names")]
-		public string SeriesNames { get; set; }
-
-		[Name("Series Order")]
-		public string SeriesOrder { get; set; }
-
-		[Name("Community Rating: Overall")]
-		public float? CommunityRatingOverall { get; set; }
-
-		[Name("Community Rating: Performance")]
-		public float? CommunityRatingPerformance { get; set; }
-
-		[Name("Community Rating: Story")]
-		public float? CommunityRatingStory { get; set; }
-
-		[Name("Cover Id")]
-		public string PictureId { get; set; }
-
-		[Name("Is Abridged?")]
-		public bool IsAbridged { get; set; }
-
-		[Name("Date Published")]
-		public DateTime? DatePublished { get; set; }
-
-		[Name("Categories")]
-		public string CategoriesNames { get; set; }
-
-		[Name("My Rating: Overall")]
-		public float? MyRatingOverall { get; set; }
-
-		[Name("My Rating: Performance")]
-		public float? MyRatingPerformance { get; set; }
-
-		[Name("My Rating: Story")]
-		public float? MyRatingStory { get; set; }
-
-		[Name("My Libation Tags")]
-		public string MyLibationTags { get; set; }
-
-		[Name("Book Liberated Status")]
-		public string BookStatus { get; set; }
-
-		[Name("PDF Liberated Status")]
-		public string PdfStatus { get; set; }
-
-		[Name("Content Type")]
-		public string ContentType { get; set; }
-
-		[Name("Language")]
-        public string Language { get; set; }
-
-		[Name("LastDownloaded")]
-		public DateTime? LastDownloaded { get; set; }
-
-		[Name("LastDownloadedVersion")]
-        public string LastDownloadedVersion { get; set; }
-
-		[Name("IsFinished")]
-        public bool IsFinished { get; set; }
-
-		[Name("IsSpatial")]
-		public bool IsSpatial { get; set; }
-
-		[Name("Last Downloaded File Version")]
-		public string LastDownloadedFileVersion { get; set; }
-
-		[Ignore /* csv ignore */]
-		public AudioFormat LastDownloadedFormat { get; set; }
-
-		[Name("Last Downloaded Codec"), JsonIgnore]
-		public string CodecString => LastDownloadedFormat?.CodecString ?? "";
-
-		[Name("Last Downloaded Sample rate"), JsonIgnore]
-		public int? SampleRate => LastDownloadedFormat?.SampleRate;
-
-		[Name("Last Downloaded Audio Channels"), JsonIgnore]
-		public int? ChannelCount => LastDownloadedFormat?.ChannelCount;
-
-		[Name("Last Downloaded Bitrate"), JsonIgnore]
-		public int? BitRate => LastDownloadedFormat?.BitRate;
+		using var csv = new CsvWriter(new System.IO.StreamWriter(saveFilePath), CultureInfo.CurrentCulture);
+		csv.WriteHeader(typeof(ExportDto));
+		csv.NextRecord();
+		csv.WriteRecords(dtos);
 	}
 
-	public static class LibToDtos
+	public static void ToJson(string saveFilePath, IEnumerable<LibraryBook>? libraryBooks = null)
 	{
-		public static List<ExportDto> ToDtos(this IEnumerable<LibraryBook> library)
-			=> library.Select(a => new ExportDto
-			{
-				Account = a.Account,
-				DateAdded = a.DateAdded,
-				AudibleProductId = a.Book.AudibleProductId,
-				Locale = a.Book.Locale,
-				Title = a.Book.Title,
-				Subtitle = a.Book.Subtitle,
-				AuthorNames = a.Book.AuthorNames,
-				NarratorNames = a.Book.NarratorNames,
-				LengthInMinutes = a.Book.LengthInMinutes,
-				Description = a.Book.Description,
-				Publisher = a.Book.Publisher,
-				HasPdf = a.Book.HasPdf,
-				SeriesNames = a.Book.SeriesNames(),
-				SeriesOrder = a.Book.SeriesLink.Any() ? a.Book.SeriesLink?.Select(sl => $"{sl.Order} : {sl.Series.Name}").Aggregate((a, b) => $"{a}, {b}") : "",
-				CommunityRatingOverall = a.Book.Rating?.OverallRating.ZeroIsNull(),
-				CommunityRatingPerformance = a.Book.Rating?.PerformanceRating.ZeroIsNull(),
-				CommunityRatingStory = a.Book.Rating?.StoryRating.ZeroIsNull(),
-				PictureId = a.Book.PictureId,
-				IsAbridged = a.Book.IsAbridged,
-				DatePublished = a.Book.DatePublished,
-				CategoriesNames = string.Join("; ", a.Book.LowestCategoryNames()),
-				MyRatingOverall = a.Book.UserDefinedItem.Rating.OverallRating.ZeroIsNull(),
-				MyRatingPerformance = a.Book.UserDefinedItem.Rating.PerformanceRating.ZeroIsNull(),
-				MyRatingStory = a.Book.UserDefinedItem.Rating.StoryRating.ZeroIsNull(),
-				MyLibationTags = a.Book.UserDefinedItem.Tags,
-				BookStatus = a.Book.UserDefinedItem.BookStatus.ToString(),
-				PdfStatus = a.Book.UserDefinedItem.PdfStatus.ToString(),
-				ContentType = a.Book.ContentType.ToString(),
-				Language = a.Book.Language,
-				LastDownloaded = a.Book.UserDefinedItem.LastDownloaded,
-				LastDownloadedVersion = a.Book.UserDefinedItem.LastDownloadedVersion?.ToString() ?? "",
-				IsFinished = a.Book.UserDefinedItem.IsFinished,
-				IsSpatial = a.Book.IsSpatial,
-				LastDownloadedFileVersion = a.Book.UserDefinedItem.LastDownloadedFileVersion ?? "",
-				LastDownloadedFormat = a.Book.UserDefinedItem.LastDownloadedFormat
-			}).ToList();
-
-		private static float? ZeroIsNull(this float value) => value is 0 ? null : value;
+		libraryBooks ??= DbContexts.GetLibrary_Flat_NoTracking();
+		var dtos = libraryBooks.ToDtos();
+		var serializer = new JsonSerializer();
+		using var writer = new JsonTextWriter(new System.IO.StreamWriter(saveFilePath)) { Formatting = Formatting.Indented };
+		serializer.Serialize(writer, dtos);
 	}
-	public static class LibraryExporter
+
+	public static void ToXlsx(string saveFilePath, IEnumerable<LibraryBook>? libraryBooks = null)
 	{
-		public static void ToCsv(string saveFilePath)
-		{
-			var dtos = DbContexts.GetLibrary_Flat_NoTracking().ToDtos();
-			if (!dtos.Any())
-				return;
-			using var writer = new System.IO.StreamWriter(saveFilePath);
-			using var csv = new CsvWriter(writer, System.Globalization.CultureInfo.CurrentCulture);
+		libraryBooks ??= DbContexts.GetLibrary_Flat_NoTracking();
+		var dtos = libraryBooks.ToDtos();
 
-			csv.WriteHeader(typeof(ExportDto));
-			csv.NextRecord();
-			csv.WriteRecords(dtos);
+		using var workbook = new XLWorkbook();
+		var sheet = workbook.AddWorksheet("Library");
+		var columns = typeof(ExportDto).GetProperties().Where(p => p.GetCustomAttribute<NameAttribute>() is not null).ToArray();
+
+		// headers
+		var currentRow = sheet.FirstRow();
+		var currentCell = currentRow.FirstCell();
+		foreach (var column in columns)
+		{
+			currentCell.Value = GetColumnName(column);
+			currentCell.Style.Font.Bold = true;
+			currentCell = currentCell.CellRight();
 		}
 
-		public static void ToJson(string saveFilePath)
+		var dateFormat = CultureInfo.CurrentCulture.DateTimeFormat.ShortDatePattern + " HH:mm:ss";
+
+		// Add data rows
+		foreach (var dto in dtos)
 		{
-			var dtos = DbContexts.GetLibrary_Flat_NoTracking().ToDtos();
-			var json = JsonConvert.SerializeObject(dtos, Formatting.Indented);
-			System.IO.File.WriteAllText(saveFilePath, json);
-		}
+			currentRow = currentRow.RowBelow();
+			currentCell = currentRow.FirstCell();
 
-		public static void ToXlsx(string saveFilePath)
-		{
-			var dtos = DbContexts.GetLibrary_Flat_NoTracking().ToDtos();
-
-			using var workbook = new XLWorkbook();
-			var sheet = workbook.AddWorksheet("Library");
-
-
-			// headers
-			var columns = new[] {
-				nameof(ExportDto.Account),
-				nameof(ExportDto.DateAdded),
-				nameof(ExportDto.AudibleProductId),
-				nameof(ExportDto.Locale),
-				nameof(ExportDto.Title),
-				nameof(ExportDto.Subtitle),
-				nameof(ExportDto.AuthorNames),
-				nameof(ExportDto.NarratorNames),
-				nameof(ExportDto.LengthInMinutes),
-				nameof(ExportDto.Description),
-				nameof(ExportDto.Publisher),
-				nameof(ExportDto.HasPdf),
-				nameof(ExportDto.SeriesNames),
-				nameof(ExportDto.SeriesOrder),
-				nameof(ExportDto.CommunityRatingOverall),
-				nameof(ExportDto.CommunityRatingPerformance),
-				nameof(ExportDto.CommunityRatingStory),
-				nameof(ExportDto.PictureId),
-				nameof(ExportDto.IsAbridged),
-				nameof(ExportDto.DatePublished),
-				nameof(ExportDto.CategoriesNames),
-				nameof(ExportDto.MyRatingOverall),
-				nameof(ExportDto.MyRatingPerformance),
-				nameof(ExportDto.MyRatingStory),
-				nameof(ExportDto.MyLibationTags),
-				nameof(ExportDto.BookStatus),
-				nameof(ExportDto.PdfStatus),
-				nameof(ExportDto.ContentType),
-                nameof(ExportDto.Language),
-                nameof(ExportDto.LastDownloaded),
-                nameof(ExportDto.LastDownloadedVersion),
-                nameof(ExportDto.IsFinished),
-                nameof(ExportDto.IsSpatial),
-                nameof(ExportDto.LastDownloadedFileVersion),
-                nameof(ExportDto.CodecString),
-                nameof(ExportDto.SampleRate),
-                nameof(ExportDto.ChannelCount),
-                nameof(ExportDto.BitRate)
-            };
-
-			int rowIndex = 1, col = 1;
-			var headerRow = sheet.Row(rowIndex++);
-			foreach (var c in columns)
+			foreach (var column in columns)
 			{
-				var headerCell = headerRow.Cell(col++);
-				headerCell.Value = ExportDto.GetName(c);
-				headerCell.Style.Font.Bold = true;
+				var value = column.GetValue(dto);
+				currentCell.Value = XLCellValue.FromObject(value);
+				currentCell.Style.DateFormat.Format = currentCell.DataType is XLDataType.DateTime ? dateFormat : string.Empty;
+				currentCell = currentCell.CellRight();
 			}
-
-			var dateFormat = CultureInfo.CurrentCulture.DateTimeFormat.ShortDatePattern + " HH:mm:ss";
-
-			// Add data rows
-			foreach (var dto in dtos)
-			{
-				col = 1;
-				var row = sheet.Row(rowIndex++);
-
-				row.Cell(col++).Value = dto.Account;
-				row.Cell(col++).SetDate(dto.DateAdded, dateFormat);
-				row.Cell(col++).Value = dto.AudibleProductId;
-				row.Cell(col++).Value = dto.Locale;
-				row.Cell(col++).Value = dto.Title;
-				row.Cell(col++).Value = dto.Subtitle;
-				row.Cell(col++).Value = dto.AuthorNames;
-				row.Cell(col++).Value = dto.NarratorNames;
-				row.Cell(col++).Value = dto.LengthInMinutes;
-				row.Cell(col++).Value = dto.Description;
-				row.Cell(col++).Value = dto.Publisher;
-				row.Cell(col++).Value = dto.HasPdf;
-				row.Cell(col++).Value = dto.SeriesNames;
-				row.Cell(col++).Value = dto.SeriesOrder;
-				row.Cell(col++).Value = dto.CommunityRatingOverall;
-				row.Cell(col++).Value = dto.CommunityRatingPerformance;
-				row.Cell(col++).Value = dto.CommunityRatingStory;
-				row.Cell(col++).Value = dto.PictureId;
-				row.Cell(col++).Value = dto.IsAbridged;
-				row.Cell(col++).SetDate(dto.DatePublished, dateFormat);
-				row.Cell(col++).Value = dto.CategoriesNames;
-				row.Cell(col++).Value = dto.MyRatingOverall;
-				row.Cell(col++).Value = dto.MyRatingPerformance;
-				row.Cell(col++).Value = dto.MyRatingStory;
-				row.Cell(col++).Value = dto.MyLibationTags;
-				row.Cell(col++).Value = dto.BookStatus;
-				row.Cell(col++).Value = dto.PdfStatus;
-				row.Cell(col++).Value = dto.ContentType;
-				row.Cell(col++).Value = dto.Language;
-				row.Cell(col++).SetDate(dto.LastDownloaded, dateFormat);
-				row.Cell(col++).Value = dto.LastDownloadedVersion;
-				row.Cell(col++).Value = dto.IsFinished;
-				row.Cell(col++).Value = dto.IsSpatial;
-				row.Cell(col++).Value = dto.LastDownloadedFileVersion;
-				row.Cell(col++).Value = dto.CodecString;
-				row.Cell(col++).Value = dto.SampleRate;
-				row.Cell(col++).Value = dto.ChannelCount;
-				row.Cell(col++).Value = dto.BitRate;
-			}
-
-			workbook.SaveAs(saveFilePath);
 		}
 
-		private static void SetDate(this IXLCell cell, DateTime? value, string dateFormat)
-		{
-			cell.Value = value;
-			cell.Style.DateFormat.Format = dateFormat;
-		}
+		workbook.SaveAs(saveFilePath);
 	}
+
+	private static List<ExportDto> ToDtos(this IEnumerable<LibraryBook> library)
+		=> library.Select(a => new ExportDto(a)).ToList();
+
+	private static string GetColumnName(PropertyInfo property)
+		=> property.GetCustomAttribute<NameAttribute>()?.Names?.FirstOrDefault() ?? property.Name;
 }

Source/ApplicationServices/MainSearchEngine.cs

@@ -0,0 +1,15 @@
+using LibationSearchEngine;
+
+namespace ApplicationServices;
+
+/// <summary>
+/// The main search engine used Libation.
+/// Acts as an adapter to SearchEngineCommands.Search()
+/// </summary>
+public class MainSearchEngine : ISearchEngine
+{
+	public static MainSearchEngine Instance { get; } = new MainSearchEngine();
+	private MainSearchEngine() { }
+	public SearchResultSet? GetSearchResultSet(string? searchString)
+		=> string.IsNullOrEmpty(searchString) ? null : SearchEngineCommands.Search(searchString);
+}

Source/ApplicationServices/RecordExporter.cs

@@ -8,179 +8,178 @@ using System.Collections.Generic;
 using System.Globalization;
 using System.Linq;
 
-namespace ApplicationServices
+namespace ApplicationServices;
+
+public static class RecordExporter
 {
-	public static class RecordExporter
+	public static void ToXlsx(string saveFilePath, IEnumerable<IRecord> records)
 	{
-		public static void ToXlsx(string saveFilePath, IEnumerable<IRecord> records)
+		if (!records.Any())
+			return;
+
+		using var workbook = new XLWorkbook();
+		var worksheet = workbook.AddWorksheet("Records");
+
+		// headers
+		var columns = new List<string>
 		{
-			if (!records.Any())
-				return;
+			nameof(Type.Name),
+			nameof(IRecord.Created),
+			nameof(IRecord.Start) + "_ms",
+		};
 
-			using var workbook = new XLWorkbook();
-			var worksheet = workbook.AddWorksheet("Records");
+		if (records.OfType<IAnnotation>().Any())
+		{
+			columns.Add(nameof(IAnnotation.AnnotationId));
+			columns.Add(nameof(IAnnotation.LastModified));
+		}
+		if (records.OfType<IRangeAnnotation>().Any())
+		{
+			columns.Add(nameof(IRangeAnnotation.End) + "_ms");
+			columns.Add(nameof(IRangeAnnotation.Text));
+		}
+		if (records.OfType<Clip>().Any())
+			columns.Add(nameof(Clip.Title));
 
-			// headers
-			var columns = new List<string>
+		int rowIndex = 1, col = 1;
+		var headerRow = worksheet.Row(rowIndex++);
+		foreach (var c in columns)
+		{
+			var headerCell = headerRow.Cell(col++);
+			headerCell.Value = c;
+			headerCell.Style.Font.Bold = true;
+		}
+
+		var dateFormat = CultureInfo.CurrentCulture.DateTimeFormat.ShortDatePattern + " HH:mm:ss";
+
+		// Add data rows
+		foreach (var record in records)
+		{
+			col = 1;
+			var row = worksheet.Row(rowIndex++);
+
+			row.Cell(col++).Value = record.GetType().Name;
+			row.Cell(col++).SetDate(record.Created.DateTime, dateFormat);
+			row.Cell(col++).Value = record.Start.TotalMilliseconds;
+
+			if (record is IAnnotation annotation)
 			{
-				nameof(Type.Name),
-				nameof(IRecord.Created),
-				nameof(IRecord.Start) + "_ms",
-			};
 
-			if (records.OfType<IAnnotation>().Any())
-			{
-				columns.Add(nameof(IAnnotation.AnnotationId));
-				columns.Add(nameof(IAnnotation.LastModified));
-			}
-			if (records.OfType<IRangeAnnotation>().Any())
-			{
-				columns.Add(nameof(IRangeAnnotation.End) + "_ms");
-				columns.Add(nameof(IRangeAnnotation.Text));
-			}
-			if (records.OfType<Clip>().Any())
-				columns.Add(nameof(Clip.Title));
+				row.Cell(col++).Value = annotation.AnnotationId;
+				row.Cell(col++).SetDate(annotation.LastModified.DateTime, dateFormat);
 
-			int rowIndex = 1, col = 1;
-			var headerRow = worksheet.Row(rowIndex++);
-			foreach (var c in columns)
-			{
-				var headerCell = headerRow.Cell(col++);
-				headerCell.Value = c;
-				headerCell.Style.Font.Bold = true;
-			}
-
-			var dateFormat = CultureInfo.CurrentCulture.DateTimeFormat.ShortDatePattern + " HH:mm:ss";
-
-			// Add data rows
-			foreach (var record in records)
-			{
-				col = 1;
-				var row = worksheet.Row(rowIndex++);
-
-				row.Cell(col++).Value = record.GetType().Name;
-				row.Cell(col++).SetDate(record.Created.DateTime, dateFormat);
-				row.Cell(col++).Value = record.Start.TotalMilliseconds;
-
-				if (record is IAnnotation annotation)
+				if (annotation is IRangeAnnotation rangeAnnotation)
 				{
+					row.Cell(col++).Value = rangeAnnotation.End.TotalMilliseconds;
+					row.Cell(col++).Value = rangeAnnotation.Text;
 
-					row.Cell(col++).Value = annotation.AnnotationId;
-					row.Cell(col++).SetDate(annotation.LastModified.DateTime, dateFormat);
-
-					if (annotation is IRangeAnnotation rangeAnnotation)
-					{
-						row.Cell(col++).Value = rangeAnnotation.End.TotalMilliseconds;
-						row.Cell(col++).Value = rangeAnnotation.Text;
-
-						if (rangeAnnotation is Clip clip)
-							row.Cell(col++).Value = clip.Title;
-					}
+					if (rangeAnnotation is Clip clip)
+						row.Cell(col++).Value = clip.Title;
 				}
 			}
-
-			workbook.SaveAs(saveFilePath);
 		}
 
-		private static void SetDate(this IXLCell cell, DateTime? value, string dateFormat)
-		{
-			cell.Value = value;
-			cell.Style.DateFormat.Format = dateFormat;
-		}
-		public static void ToJson(string saveFilePath, LibraryBook libraryBook, IEnumerable<IRecord> records)
-		{
-			if (!records.Any())
-				return;
+		workbook.SaveAs(saveFilePath);
+	}
 
-			var recordsEx = extendRecords(records);
+	private static void SetDate(this IXLCell cell, DateTime? value, string dateFormat)
+	{
+		cell.Value = value;
+		cell.Style.DateFormat.Format = dateFormat;
+	}
+	public static void ToJson(string saveFilePath, LibraryBook libraryBook, IEnumerable<IRecord> records)
+	{
+		if (!records.Any())
+			return;
 
-			var recordsObj = new JObject
+		var recordsEx = extendRecords(records);
+
+		var recordsObj = new JObject
+		{
+			{ "title", libraryBook.Book.TitleWithSubtitle},
+			{ "asin", libraryBook.Book.AudibleProductId},
+			{ "exportTime", DateTime.Now},
+			{ "records", JArray.FromObject(recordsEx) }
+		};
+
+		System.IO.File.WriteAllText(saveFilePath, recordsObj.ToString(Newtonsoft.Json.Formatting.Indented));
+	}
+
+	public static void ToCsv(string saveFilePath, IEnumerable<IRecord> records)
+	{
+		if (!records.Any())
+			return;
+
+		using var writer = new System.IO.StreamWriter(saveFilePath);
+		using var csv = new CsvWriter(writer, System.Globalization.CultureInfo.CurrentCulture);
+
+		//Write headers for the present record type that has the most properties
+		if (records.OfType<Clip>().Any())
+			csv.WriteHeader(typeof(ClipEx));
+		else if (records.OfType<Note>().Any())
+			csv.WriteHeader(typeof(NoteEx));
+		else if (records.OfType<Bookmark>().Any())
+			csv.WriteHeader(typeof(BookmarkEx));
+		else
+			csv.WriteHeader(typeof(LastHeardEx));
+
+		var recordsEx = extendRecords(records);
+
+		csv.NextRecord();
+		csv.WriteRecords(recordsEx.OfType<ClipEx>());
+		csv.WriteRecords(recordsEx.OfType<NoteEx>());
+		csv.WriteRecords(recordsEx.OfType<BookmarkEx>());
+		csv.WriteRecords(recordsEx.OfType<LastHeardEx>());
+	}
+
+	private static IEnumerable<IRecordEx> extendRecords(IEnumerable<IRecord> records)
+		=> records
+		.Select<IRecord, IRecordEx>(
+			r => r switch
 			{
-				{ "title", libraryBook.Book.TitleWithSubtitle},
-				{ "asin", libraryBook.Book.AudibleProductId},
-				{ "exportTime", DateTime.Now},
-				{ "records", JArray.FromObject(recordsEx) }
-			};
+				Clip c => new ClipEx(nameof(Clip), c),
+				Note n => new NoteEx(nameof(Note), n),
+				Bookmark b => new BookmarkEx(nameof(Bookmark), b),
+				LastHeard l => new LastHeardEx(nameof(LastHeard), l),
+				_ => throw new InvalidOperationException(),
+			});
 
-			System.IO.File.WriteAllText(saveFilePath, recordsObj.ToString(Newtonsoft.Json.Formatting.Indented));
-		}		
 
-		public static void ToCsv(string saveFilePath, IEnumerable<IRecord> records)
+	private interface IRecordEx { string Type { get; } }
+
+	private record LastHeardEx : LastHeard, IRecordEx
+	{
+		public string Type { get; }
+		public LastHeardEx(string type, LastHeard original) : base(original)
 		{
-			if (!records.Any())
-				return;
-
-			using var writer = new System.IO.StreamWriter(saveFilePath);
-			using var csv = new CsvWriter(writer, System.Globalization.CultureInfo.CurrentCulture);
-
-			//Write headers for the present record type that has the most properties
-			if (records.OfType<Clip>().Any())
-				csv.WriteHeader(typeof(ClipEx));
-			else if (records.OfType<Note>().Any())
-				csv.WriteHeader(typeof(NoteEx));
-			else if (records.OfType<Bookmark>().Any())
-				csv.WriteHeader(typeof(BookmarkEx));
-			else
-				csv.WriteHeader(typeof(LastHeardEx));
-
-			var recordsEx = extendRecords(records);
-
-			csv.NextRecord();
-			csv.WriteRecords(recordsEx.OfType<ClipEx>()); 
-			csv.WriteRecords(recordsEx.OfType<NoteEx>()); 
-			csv.WriteRecords(recordsEx.OfType<BookmarkEx>()); 
-			csv.WriteRecords(recordsEx.OfType<LastHeardEx>()); 
+			Type = type;
 		}
+	}
 
-		private static IEnumerable<IRecordEx> extendRecords(IEnumerable<IRecord> records)
-			=> records
-			.Select<IRecord, IRecordEx>(
-				r => r switch
-				{
-					Clip c => new ClipEx(nameof(Clip), c),
-					Note n => new NoteEx(nameof(Note), n),
-					Bookmark b => new BookmarkEx(nameof(Bookmark), b),
-					LastHeard l => new LastHeardEx(nameof(LastHeard), l),
-					_ => throw new InvalidOperationException(),
-				});
-
-
-		private interface IRecordEx { string Type { get; } }
-
-		private record LastHeardEx : LastHeard, IRecordEx
+	private record BookmarkEx : Bookmark, IRecordEx
+	{
+		public string Type { get; }
+		public BookmarkEx(string type, Bookmark original) : base(original)
 		{
-			public string Type { get; }
-			public LastHeardEx(string type, LastHeard original) : base(original)
-			{
-				Type = type;
-			}
+			Type = type;
 		}
+	}
 
-		private record BookmarkEx : Bookmark, IRecordEx
+	private record NoteEx : Note, IRecordEx
+	{
+		public string Type { get; }
+		public NoteEx(string type, Note original) : base(original)
 		{
-			public string Type { get; }
-			public BookmarkEx(string type, Bookmark original) : base(original)
-			{
-				Type = type;
-			}
+			Type = type;
 		}
+	}
 
-		private record NoteEx : Note, IRecordEx
+	private record ClipEx : Clip, IRecordEx
+	{
+		public string Type { get; }
+		public ClipEx(string type, Clip original) : base(original)
 		{
-			public string Type { get; }
-			public NoteEx(string type, Note original) : base(original)
-			{
-				Type = type;
-			}
-		}
-
-		private record ClipEx : Clip, IRecordEx
-		{
-			public string Type { get; }
-			public ClipEx(string type, Clip original) : base(original)
-			{
-				Type = type;
-			}
+			Type = type;
 		}
 	}
 }

Source/ApplicationServices/SearchEngineCommands.cs

@@ -1,20 +1,26 @@
-using System;
+using DataLayer;
+using LibationSearchEngine;
+using Serilog;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
-using DataLayer;
-using LibationSearchEngine;
 
-namespace ApplicationServices
+namespace ApplicationServices;
+
+public static class SearchEngineCommands
 {
-	public static class SearchEngineCommands
-	{
-		#region Search
-		public static SearchResultSet Search(string searchString) => performSafeQuery(e =>
-			e.Search(searchString)
-		);
+	/// <summary>Serializes all search index access so only one reader/writer is active at a time, avoiding write.lock contention.</summary>
+	private static readonly object IndexLock = new();
 
-		private static T performSafeQuery<T>(Func<SearchEngine, T> func)
+	#region Search
+	public static SearchResultSet Search(string searchString) => performSafeQuery(e =>
+		e.Search(searchString)
+	);
+
+	private static T performSafeQuery<T>(Func<SearchEngine, T> func)
+	{
+		lock (IndexLock)
 		{
 			var engine = new SearchEngine();
 			try
@@ -26,57 +32,72 @@ namespace ApplicationServices
 				fullReIndex(engine);
 				return func(engine);
 			}
-		}
-		#endregion
-
-		public static event EventHandler SearchEngineUpdated;
-
-		#region Update
-		private static bool isUpdating;
-
-		public static void UpdateBooks(IEnumerable<LibraryBook> books)
-		{
-			// Semi-arbitrary. At some point it's more worth it to do a full re-index than to do one offs.
-			// I did not benchmark before choosing the number here
-			if (books.Count() > 15)
-				FullReIndex();
-			else
+			catch (Exception ex) when (SearchEngine.IsRecoverableCorruptIndexException(ex))
 			{
-				foreach (var book in books)
-					UpdateUserDefinedItems(book);
+				Log.Warning(ex, "Search index unreadable or corrupt; rebuilding and retrying query.");
+				fullReIndex(engine);
+				return func(engine);
 			}
 		}
+	}
+	#endregion
 
-		public static void FullReIndex() => performSafeCommand(fullReIndex);
-		public static void FullReIndex(List<LibraryBook> libraryBooks)
-			=> performSafeCommand(se => fullReIndex(se, libraryBooks.WithoutParents()));
+	public static event EventHandler? SearchEngineUpdated;
 
-		internal static void UpdateUserDefinedItems(LibraryBook book) => performSafeCommand(e =>
-			{
-				e.UpdateLiberatedStatus(book);
-				e.UpdateTags(book.Book.AudibleProductId, book.Book.UserDefinedItem.Tags);
-				e.UpdateUserRatings(book);
-			}
-		);
+	#region Update
+	private static bool isUpdating;
 
-		private static void performSafeCommand(Action<SearchEngine> action)
+	public static void UpdateBooks(IEnumerable<LibraryBook> books)
+	{
+		// Semi-arbitrary. At some point it's more worth it to do a full re-index than to do one offs.
+		// I did not benchmark before choosing the number here
+		if (books.Count() > 15)
+			FullReIndex();
+		else
 		{
-			try
-			{
-				update(action);
-			}
-			catch (FileNotFoundException)
-			{
-				fullReIndex(new SearchEngine());
-				update(action);
-			}
+			foreach (var book in books)
+				UpdateUserDefinedItems(book);
 		}
+	}
 
-		private static void update(Action<SearchEngine> action)
+	public static void FullReIndex() => performSafeCommand(fullReIndex);
+	public static void FullReIndex(List<LibraryBook> libraryBooks)
+		=> performSafeCommand(se => fullReIndex(se, libraryBooks.WithoutParents()));
+
+	internal static void UpdateUserDefinedItems(LibraryBook book) => performSafeCommand(e =>
 		{
-			if (action is null)
-				return;
+			e.UpdateLiberatedStatus(book);
+			e.UpdateTags(book.Book.AudibleProductId, book.Book.UserDefinedItem.Tags);
+			e.UpdateUserRatings(book);
+		}
+	);
 
+	private static void performSafeCommand(Action<SearchEngine> action)
+	{
+		try
+		{
+			update(action);
+		}
+		catch (FileNotFoundException)
+		{
+			fullReIndex(new SearchEngine());
+			update(action);
+		}
+		catch (Exception ex) when (SearchEngine.IsRecoverableCorruptIndexException(ex))
+		{
+			Log.Warning(ex, "Search index unreadable or corrupt; rebuilding and retrying.");
+			fullReIndex(new SearchEngine());
+			update(action);
+		}
+	}
+
+	private static void update(Action<SearchEngine> action)
+	{
+		if (action is null)
+			return;
+
+		lock (IndexLock)
+		{
 			// support nesting incl recursion
 			var prevIsUpdating = isUpdating;
 			try
@@ -85,22 +106,22 @@ namespace ApplicationServices
 
 				action(new SearchEngine());
 				if (!prevIsUpdating)
-					SearchEngineUpdated?.Invoke(null, null);
+					SearchEngineUpdated?.Invoke(null, EventArgs.Empty);
 			}
 			finally
 			{
 				isUpdating = prevIsUpdating;
 			}
 		}
-
-		private static void fullReIndex(SearchEngine engine)
-		{
-			var library = DbContexts.GetLibrary_Flat_NoTracking();
-			fullReIndex(engine, library);
-		}
-
-		private static void fullReIndex(SearchEngine engine, IEnumerable<LibraryBook> libraryBooks)
-		=> engine.CreateNewIndex(libraryBooks);
-		#endregion
 	}
+
+	private static void fullReIndex(SearchEngine engine)
+	{
+		var library = DbContexts.GetLibrary_Flat_NoTracking();
+		fullReIndex(engine, library);
+	}
+
+	private static void fullReIndex(SearchEngine engine, IEnumerable<LibraryBook> libraryBooks)
+	=> engine.CreateNewIndex(libraryBooks);
+	#endregion
 }

Source/ApplicationServices/TempSearchEngine.cs

@@ -0,0 +1,44 @@
+using DataLayer;
+using LibationFileManager;
+using LibationSearchEngine;
+using System.Collections.Generic;
+
+namespace ApplicationServices;
+
+/// <summary>
+/// A temporary search engine created in InProgress/TempSearchEngine
+/// Used for Trash Bin searches to avoid interfering with the main search engine
+/// </summary>
+public class TempSearchEngine : ISearchEngine
+{
+	public static string SearchEnginePath { get; }
+		= System.IO.Path.Combine(Configuration.Instance.InProgress, nameof(TempSearchEngine));
+	private SearchEngine SearchEngine { get; } = new SearchEngine(SearchEnginePath);
+
+	public bool ReindexSearchEngine(IEnumerable<LibraryBook> books)
+	{
+		try
+		{
+			SearchEngine.CreateNewIndex(books, overwrite: true);
+			return true;
+		}
+		catch
+		{
+			return false;
+		}
+	}
+	public SearchResultSet? GetSearchResultSet(string? searchString)
+	{
+		if (string.IsNullOrEmpty(searchString))
+			return null;
+
+		try
+		{
+			return SearchEngine.Search(searchString);
+		}
+		catch
+		{
+			return null;
+		}
+	}
+}

Source/AudibleUtilities/Account.cs

@@ -1,99 +1,98 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AudibleApi;
+using AudibleApi;
 using AudibleApi.Authorization;
 using Dinah.Core;
 using Newtonsoft.Json;
+using System;
+using System.Diagnostics.CodeAnalysis;
 
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+public class Account : IUpdatable
 {
-	public class Account : IUpdatable
+	public event EventHandler? Updated;
+	private void update(object? sender = null, EventArgs? e = null)
+		=> Updated?.Invoke(this, EventArgs.Empty);
+
+	// canonical. immutable. email or phone number
+	public string AccountId { get; }
+
+	// user-friendly, non-canonical name. mutable
+	public string? AccountName
 	{
-		public event EventHandler Updated;
-		private void update(object sender = null, EventArgs e = null)
-			=> Updated?.Invoke(this, new EventArgs());
-
-		// canonical. immutable. email or phone number
-		public string AccountId { get; }
-
-		// user-friendly, non-canonical name. mutable
-		public string AccountName
+		get => field;
+		set
 		{
-			get => field;
-			set
-			{
-				if (string.IsNullOrWhiteSpace(value))
-					return;
-				var v = value.Trim();
-				if (v == field)
-					return;
-				field = v;
-				update();
-			}
+			if (string.IsNullOrWhiteSpace(value))
+				return;
+			var v = value.Trim();
+			if (v == field)
+				return;
+			field = v;
+			update();
 		}
-
-		// whether to include this account when scanning libraries.
-		// technically this is an app setting; not an attribute of account. but since it's managed with accounts, it makes sense to put this exception-to-the-rule here
-		public bool LibraryScan
-		{
-			get => field;
-			set
-			{
-				if (value == field)
-					return;
-				field = value;
-				update();
-			}
-		}
-
-		/// <summary>aka: activation bytes</summary>
-		public string DecryptKey
-		{
-			get => field ?? "";
-			set
-			{
-				var v = (value ?? "").Trim();
-				if (v == field)
-					return;
-				field = v;
-				update();
-			}
-		}
-
-		public Identity IdentityTokens
-		{
-			get => field;
-			set
-			{
-				if (field is null && value is null)
-					return;
-
-				if (field is not null)
-					field.Updated -= update;
-
-				if (value is not null)
-					value.Updated += update;
-
-				field = value;
-				update();
-			}
-		}
-
-		[JsonIgnore]
-		public Locale Locale => IdentityTokens?.Locale;
-
-		public Account(string accountId)
-		{
-			AccountId = ArgumentValidator.EnsureNotNullOrWhiteSpace(accountId, nameof(accountId)).Trim();
-		}
-
-		public override string ToString() => $"{AccountId} - {Locale?.Name ?? "[empty]"}";
-
-		public string MaskedLogEntry => @$"AccountId={mask(AccountId)}|AccountName={mask(AccountName)}|Locale={Locale?.Name ?? "[empty]"}";
-		private static string mask(string str)
-			=> str is null ? "[null]"
-			: str == string.Empty ? "[empty]"
-			: str.ToMask();
 	}
+
+	// whether to include this account when scanning libraries.
+	// technically this is an app setting; not an attribute of account. but since it's managed with accounts, it makes sense to put this exception-to-the-rule here
+	public bool LibraryScan
+	{
+		get => field;
+		set
+		{
+			if (value == field)
+				return;
+			field = value;
+			update();
+		}
+	}
+
+	/// <summary>aka: activation bytes</summary>
+	[AllowNull]
+	public string? DecryptKey
+	{
+		get => field;
+		set
+		{
+			var v = (value ?? "").Trim();
+			if (v == field)
+				return;
+			field = v;
+			update();
+		}
+	}
+
+	public Identity? IdentityTokens
+	{
+		get => field;
+		set
+		{
+			if (field is null && value is null)
+				return;
+
+			if (field is not null)
+				field.Updated -= update;
+
+			if (value is not null)
+				value.Updated += update;
+
+			field = value;
+			update();
+		}
+	}
+
+	[JsonIgnore]
+	public Locale? Locale => IdentityTokens?.Locale;
+
+	public Account(string accountId)
+	{
+		AccountId = ArgumentValidator.EnsureNotNullOrWhiteSpace(accountId, nameof(accountId)).Trim();
+	}
+
+	public override string ToString() => $"{AccountId} - {Locale?.Name ?? "[empty]"}";
+
+	public string MaskedLogEntry => @$"AccountId={mask(AccountId)}|AccountName={mask(AccountName)}|Locale={Locale?.Name ?? "[empty]"}";
+	private static string mask(string? str)
+		=> str is null ? "[null]"
+		: str == string.Empty ? "[empty]"
+		: str.ToMask();
 }

Source/AudibleUtilities/AccountsSettings.cs

@@ -1,159 +1,158 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AudibleApi;
+using AudibleApi;
 using AudibleApi.Authorization;
 using Dinah.Core;
 using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
 
-#nullable enable
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+// 'AccountsSettings' is intentionally NOT IEnumerable<> so that properties can be added/extended
+// from newtonsoft (https://www.newtonsoft.com/json/help/html/SerializationGuide.htm):
+//   .NET :  IList, IEnumerable, IList<T>, Array
+//   JSON :  Array (properties on the collection will not be serialized)
+public class AccountsSettings : IUpdatable
 {
-	// 'AccountsSettings' is intentionally NOT IEnumerable<> so that properties can be added/extended
-	// from newtonsoft (https://www.newtonsoft.com/json/help/html/SerializationGuide.htm):
-	//   .NET :  IList, IEnumerable, IList<T>, Array
-	//   JSON :  Array (properties on the collection will not be serialized)
-	public class AccountsSettings : IUpdatable
+	public event EventHandler? Updated;
+	private void update(object? sender = null, EventArgs? e = null)
 	{
-		public event EventHandler? Updated;
-		private void update(object? sender = null, EventArgs? e = null)
-		{
-			foreach (var account in Accounts)
-				validate(account);
-			update_no_validate();
-		}
-		private void update_no_validate() => Updated?.Invoke(this, new EventArgs());
-
-		public AccountsSettings() { }
-
-		// for some reason this will make the json instantiator use _accounts_json.set()
-		[JsonConstructor]
-		protected AccountsSettings(List<Account> accountsSettings) { }
-
-		#region Accounts
-		private List<Account> _accounts_backing = new List<Account>();
-		[JsonProperty(PropertyName = nameof(Accounts))]
-		private List<Account> _accounts_json
-		{
-			get => _accounts_backing;
-			// 'set' is only used by json deser
-			set
-			{
-				if (value is null)
-					return;
-
-				foreach (var account in value)
-					_add(account);
-
-				update_no_validate();
-			}
-		}
-
-		private string? _cdm;
-		[JsonProperty]
-		public string? Cdm
-		{
-			get => _cdm;
-			set
-			{
-				if (value is null)
-					return;
-
-				_cdm = value;
-				update_no_validate();
-			}
-		}
-
-		[JsonIgnore]
-		public IReadOnlyList<Account> Accounts => _accounts_json.AsReadOnly();
-		#endregion
-
-		#region de/serialize
-		public static AccountsSettings? FromJson(string json)
-			=> JsonConvert.DeserializeObject<AccountsSettings>(json, Identity.GetJsonSerializerSettings());
-
-		public string ToJson(Formatting formatting = Formatting.Indented)
-			=> JsonConvert.SerializeObject(this, formatting, Identity.GetJsonSerializerSettings());
-		#endregion
-
-		// more common naming convention alias for internal collection
-		public IReadOnlyList<Account> GetAll() => Accounts;
-
-		public Account Upsert(string accountId, string locale)
-		{
-			var acct = GetAccount(accountId, locale);
-
-			if (acct is not null)
-				return acct;
-
-			var l = Localization.Get(locale);
-			var id = new Identity(l);
-
-			var account = new Account(accountId) { IdentityTokens = id };
-			Add(account);
-			return account;
-		}
-
-		public void Add(Account account)
-		{
-			_add(account);
-			update_no_validate();
-		}
-
-		public void _add(Account account)
-		{
+		foreach (var account in Accounts)
 			validate(account);
+		update_no_validate();
+	}
+	private void update_no_validate() => Updated?.Invoke(this, new EventArgs());
 
-			_accounts_backing.Add(account);
-			account.Updated += update;
-		}
+	public AccountsSettings() { }
 
-		public Account? GetAccount(string accountId, string? locale)
+	// for some reason this will make the json instantiator use _accounts_json.set()
+	[JsonConstructor]
+	protected AccountsSettings(List<Account> accountsSettings) { }
+
+	#region Accounts
+	private readonly List<Account> _accounts_backing = new List<Account>();
+	[JsonProperty(PropertyName = nameof(Accounts))]
+	private List<Account> _accounts_json
+	{
+		get => _accounts_backing;
+		// 'set' is only used by json deser
+		set
 		{
-			if (locale is null)
-				return null;
+			if (value is null)
+				return;
 
-			return Accounts.SingleOrDefault(a => a.AccountId == accountId && a.IdentityTokens.Locale.Name == locale);
-		}
+			foreach (var account in value)
+				_add(account);
 
-		public bool Delete(string accountId, string locale)
-		{
-			var acct = GetAccount(accountId, locale);
-			if (acct is null)
-				return false;
-			return Delete(acct);
-		}
-
-		public bool Delete(Account account)
-		{
-			if (!_accounts_backing.Contains(account))
-				return false;
-
-			account.Updated -= update;
-			var result = _accounts_backing.Remove(account);
 			update_no_validate();
-			return result;
-		}
-
-		private void validate(Account account)
-		{
-			ArgumentValidator.EnsureNotNull(account, nameof(account));
-
-			var accountId = account.AccountId;
-			var locale = account?.IdentityTokens?.Locale?.Name;
-
-			var acct = GetAccount(accountId, locale);
-
-			// new: ok
-			if (acct is null)
-				return;
-
-			// same account instance: ok
-			if (acct == account)
-				return;
-			
-			// same account id + locale, different instance: bad
-			throw new InvalidOperationException("Cannot add an account with the same account Id and Locale");
 		}
 	}
+
+	private string? _cdm;
+	[JsonProperty]
+	public string? Cdm
+	{
+		get => _cdm;
+		set
+		{
+			if (value is null)
+				return;
+
+			_cdm = value;
+			update_no_validate();
+		}
+	}
+
+	[JsonIgnore]
+	public IReadOnlyList<Account> Accounts => _accounts_json.AsReadOnly();
+	#endregion
+
+	#region de/serialize
+	public static AccountsSettings? FromJson(string json)
+		=> JsonConvert.DeserializeObject<AccountsSettings>(json, Identity.GetJsonSerializerSettings());
+
+	public string ToJson(Formatting formatting = Formatting.Indented)
+		=> JsonConvert.SerializeObject(this, formatting, Identity.GetJsonSerializerSettings());
+	#endregion
+
+	// more common naming convention alias for internal collection
+	public IReadOnlyList<Account> GetAll() => Accounts;
+
+	public Account Upsert(string accountId, string? locale)
+	{
+		var acct = GetAccount(accountId, locale);
+
+		if (acct is not null)
+			return acct;
+
+		var l = Localization.Get(locale);
+		var id = new Identity(l);
+
+		// Match GUI default for new rows (WinForms/Avalonia): include account in library scans.
+		var account = new Account(accountId) { IdentityTokens = id, LibraryScan = true };
+		Add(account);
+		return account;
+	}
+
+	public void Add(Account account)
+	{
+		_add(account);
+		update_no_validate();
+	}
+
+	public void _add(Account account)
+	{
+		validate(account);
+
+		_accounts_backing.Add(account);
+		account.Updated += update;
+	}
+
+	public Account? GetAccount(string accountId, string? locale)
+	{
+		if (locale is null)
+			return null;
+
+		return Accounts.SingleOrDefault(a => a.AccountId == accountId && a.Locale?.Name == locale);
+	}
+
+	public bool Delete(string accountId, string locale)
+	{
+		var acct = GetAccount(accountId, locale);
+		if (acct is null)
+			return false;
+		return Delete(acct);
+	}
+
+	public bool Delete(Account account)
+	{
+		if (!_accounts_backing.Contains(account))
+			return false;
+
+		account.Updated -= update;
+		var result = _accounts_backing.Remove(account);
+		update_no_validate();
+		return result;
+	}
+
+	private void validate(Account account)
+	{
+		ArgumentValidator.EnsureNotNull(account, nameof(account));
+
+		var accountId = account.AccountId;
+		var locale = account?.IdentityTokens?.Locale?.Name;
+
+		var acct = GetAccount(accountId, locale);
+
+		// new: ok
+		if (acct is null)
+			return;
+
+		// same account instance: ok
+		if (acct == account)
+			return;
+
+		// same account id + locale, different instance: bad
+		throw new InvalidOperationException("Cannot add an account with the same account Id and Locale");
+	}
 }

Source/AudibleUtilities/AccountsSettingsPersister.cs

@@ -1,30 +1,29 @@
-using System;
-using AudibleApi.Authorization;
+using AudibleApi.Authorization;
 using Dinah.Core.IO;
 using Newtonsoft.Json;
+using System;
 
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+public class AccountsSettingsPersister : JsonFilePersister<AccountsSettings>
 {
-	public class AccountsSettingsPersister : JsonFilePersister<AccountsSettings>
-	{
-		public static event EventHandler Saving;
-		public static event EventHandler Saved;
+	public static event EventHandler? Saving;
+	public static event EventHandler? Saved;
 
-		protected override void OnSaving() => Saving?.Invoke(null, null);
-		protected override void OnSaved() => Saved?.Invoke(null, null);
+	protected override void OnSaving() => Saving?.Invoke(null, EventArgs.Empty);
+	protected override void OnSaved() => Saved?.Invoke(null, EventArgs.Empty);
 
-		/// <summary>Alias for Target </summary>
-		public AccountsSettings AccountsSettings => Target;
+	/// <summary>Alias for Target </summary>
+	public AccountsSettings AccountsSettings => Target;
 
-		/// <summary>uses path. create file if doesn't yet exist</summary>
-		public AccountsSettingsPersister(AccountsSettings target, string path, string jsonPath = null)
-			: base(target, path, jsonPath) { }
+	/// <summary>uses path. create file if doesn't yet exist</summary>
+	public AccountsSettingsPersister(AccountsSettings target, string path, string? jsonPath = null)
+		: base(target, path, jsonPath) { }
 
-		/// <summary>load from existing file</summary>
-		public AccountsSettingsPersister(string path, string jsonPath = null)
-			: base(path, jsonPath) { }
+	/// <summary>load from existing file</summary>
+	public AccountsSettingsPersister(string path, string? jsonPath = null)
+		: base(path, jsonPath) { }
 
-		protected override JsonSerializerSettings GetSerializerSettings()
-			=> Identity.GetJsonSerializerSettings();
-	}
+	protected override JsonSerializerSettings GetSerializerSettings()
+		=> Identity.GetJsonSerializerSettings();
 }

Source/AudibleUtilities/ApiExtended.cs

@@ -1,288 +1,312 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Channels;
-using System.Threading.Tasks;
-using System.Diagnostics;
-using AudibleApi;
+using AudibleApi;
 using AudibleApi.Common;
 using Dinah.Core;
+using LibationFileManager;
+using Newtonsoft.Json.Linq;
 using Polly;
 using Polly.Retry;
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
 using System.Threading;
+using System.Threading.Channels;
+using System.Threading.Tasks;
 
-#nullable enable
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+/// <summary>USE THIS from within Libation. It wraps the call with correct JSONPath</summary>
+public class ApiExtended
 {
-	/// <summary>USE THIS from within Libation. It wraps the call with correct JSONPath</summary>
-	public class ApiExtended
+	public static Func<Account, ILoginChoiceEager>? LoginChoiceFactory { get; set; }
+	public Api Api { get; private set; }
+
+	private const int MaxConcurrency = 10;
+	private const int BatchSize = 50;
+
+	private ApiExtended(Api api) => Api = api;
+
+	/// <summary>Get api from existing tokens else login with 'eager' choice. External browser url is provided. Response can be external browser login or continuing with native api callbacks.</summary>
+	public static async Task<ApiExtended> CreateAsync(Account account)
 	{
-		public static Func<Account, ILoginChoiceEager>? LoginChoiceFactory { get; set; }
-		public Api Api { get; private set; }
+		ArgumentValidator.EnsureNotNull(account, nameof(account));
+		ArgumentValidator.EnsureNotNull(account.AccountId, nameof(account.AccountId));
+		var locale = ArgumentValidator.EnsureNotNull(account.Locale, nameof(account.Locale));
 
-		private const int MaxConcurrency = 10;
-		private const int BatchSize = 50;
-
-		private ApiExtended(Api api) => Api = api;
-
-		/// <summary>Get api from existing tokens else login with 'eager' choice. External browser url is provided. Response can be external browser login or continuing with native api callbacks.</summary>
-		public static async Task<ApiExtended> CreateAsync(Account account)
+		try
 		{
-			ArgumentValidator.EnsureNotNull(account, nameof(account));
-			ArgumentValidator.EnsureNotNull(account.AccountId, nameof(account.AccountId));
-			ArgumentValidator.EnsureNotNull(account.Locale, nameof(account.Locale));
-
-			try
+			Serilog.Log.Logger.Information("{@DebugInfo}", new
 			{
-				Serilog.Log.Logger.Information("{@DebugInfo}", new
-				{
-					AccountMaskedLogEntry = account.MaskedLogEntry
-				});
+				AccountMaskedLogEntry = account.MaskedLogEntry
+			});
 
-				var api = await EzApiCreator.GetApiAsync(
-						account.Locale,
-						AudibleApiStorage.AccountsSettingsFile,
-						account.GetIdentityTokensJsonPath());
-				return new ApiExtended(api);
-			}
-			catch
-			{
-				if (LoginChoiceFactory is null)
-					throw new InvalidOperationException($"The UI module must first set {nameof(LoginChoiceFactory)} before attempting to create the api");
-
-				Serilog.Log.Logger.Information("{@DebugInfo}", new
-				{
-					LoginType = nameof(ILoginChoiceEager),
-					Account = account.MaskedLogEntry ?? "[null]",
-					LocaleName = account.Locale?.Name
-				});
-
-				var api = await EzApiCreator.GetApiAsync(
-					LoginChoiceFactory(account),
-					account.Locale,
+			var api = await EzApiCreator.GetApiAsync(
+					locale,
 					AudibleApiStorage.AccountsSettingsFile,
 					account.GetIdentityTokensJsonPath());
-
-				return new ApiExtended(api);
-			}
-		}	
-
-		private static AsyncRetryPolicy policy { get; }
-			= Policy.Handle<Exception>()
-			// 2 retries == 3 total
-			.RetryAsync(2);
-
-		public Task<List<Item>> GetLibraryValidatedAsync(LibraryOptions libraryOptions, bool importEpisodes = true)
+			return new ApiExtended(api);
+		}
+		catch
 		{
-			// bug on audible's side. the 1st time after a long absence, a query to get library will return without titles or authors. a subsequent identical query will be successful. this is true whether or not tokens are refreshed
-			// worse, this 1st dummy call doesn't seem to help:
-			//    var page = await api.GetLibraryAsync(new AudibleApi.LibraryOptions { NumberOfResultPerPage = 1, PageNumber = 1, PurchasedAfter = DateTime.Now.AddYears(-20), ResponseGroups = AudibleApi.LibraryOptions.ResponseGroupOptions.ALL_OPTIONS });
-			// i don't want to incur the cost of making a full dummy call every time because it fails sometimes
-			return policy.ExecuteAsync(() => getItemsAsync(libraryOptions, importEpisodes));
+			if (LoginChoiceFactory is null)
+				throw new InvalidOperationException($"The UI module must first set {nameof(LoginChoiceFactory)} before attempting to create the api");
+
+			Serilog.Log.Logger.Information("{@DebugInfo}", new
+			{
+				LoginType = nameof(ILoginChoiceEager),
+				Account = account.MaskedLogEntry ?? "[null]",
+				LocaleName = locale.Name
+			});
+
+			var api = await EzApiCreator.GetApiAsync(
+				LoginChoiceFactory(account),
+				locale,
+				AudibleApiStorage.AccountsSettingsFile,
+				account.GetIdentityTokensJsonPath());
+
+			return new ApiExtended(api);
+		}
+	}
+
+	private static AsyncRetryPolicy policy { get; }
+		= Policy.Handle<Exception>()
+		// 2 retries == 3 total
+		.RetryAsync(2);
+
+	public Task<List<Item>> GetLibraryValidatedAsync(LibraryOptions libraryOptions)
+	{
+		// bug on audible's side. the 1st time after a long absence, a query to get library will return without titles or authors. a subsequent identical query will be successful. this is true whether or not tokens are refreshed
+		// worse, this 1st dummy call doesn't seem to help:
+		//    var page = await api.GetLibraryAsync(new AudibleApi.LibraryOptions { NumberOfResultPerPage = 1, PageNumber = 1, PurchasedAfter = DateTime.Now.AddYears(-20), ResponseGroups = AudibleApi.LibraryOptions.ResponseGroupOptions.ALL_OPTIONS });
+		// i don't want to incur the cost of making a full dummy call every time because it fails sometimes
+		return policy.ExecuteAsync(() => getItemsAsync(libraryOptions));
+	}
+
+	/// <summary>
+	/// A debugging method used to simulate a library scan from a LibraryScans.zip json file.
+	/// Simply replace the Api call to GetLibraryItemsPagesAsync() with a call to this method.
+	/// </summary>
+	private static async IAsyncEnumerable<Item[]> GetItemsFromJsonFile()
+	{
+		var libraryScanJsonPath = @"Path/to/libraryscan.json";
+		using var jsonFile = System.IO.File.OpenText(libraryScanJsonPath);
+
+		var json = await JToken.ReadFromAsync(new Newtonsoft.Json.JsonTextReader(jsonFile));
+		if (json?["Items"] is not JArray items)
+			yield break;
+
+		foreach (var batch in items.OfType<JObject>().Select(Item.FromJson).OfType<Item>().Chunk(BatchSize))
+			yield return batch;
+	}
+
+	private async Task<List<Item>> getItemsAsync(LibraryOptions libraryOptions)
+	{
+		Serilog.Log.Logger.Debug("Beginning library scan.");
+
+		List<Item> items = new();
+		var sw = Stopwatch.StartNew();
+		var totalTime = TimeSpan.Zero;
+		using var semaphore = new SemaphoreSlim(MaxConcurrency);
+
+		var episodeChannel = Channel.CreateUnbounded<string>(new UnboundedChannelOptions { SingleReader = true, SingleWriter = true });
+		var batchReaderTask = readAllAsinsAsync(episodeChannel.Reader, semaphore);
+
+		//Scan the library for all added books.
+		//Get relationship asins from episode-type items and write them to episodeChannel where they will be batched and queried.
+		await foreach (var itemsBatch in Api.GetLibraryItemsPagesAsync(libraryOptions, BatchSize, semaphore))
+		{
+			if (Configuration.Instance.ImportEpisodes)
+			{
+				var episodes = itemsBatch.Where(i => i.IsEpisodes).ToList();
+				var series = itemsBatch.Where(i => i.IsSeriesParent).ToList();
+
+				var parentAsins = episodes
+					.SelectMany(i => i.Relationships ?? [])
+					.Where(r => r.RelationshipToProduct == RelationshipToProduct.Parent)
+					.Select(r => r.Asin)
+					.OfType<string>();
+
+				var episodeAsins = series
+					.SelectMany(i => i.Relationships ?? [])
+					.Where(r => r.RelationshipToProduct == RelationshipToProduct.Child && r.RelationshipType == RelationshipType.Episode)
+					.Select(r => r.Asin)
+					.OfType<string>();
+
+				foreach (var asin in parentAsins.Concat(episodeAsins))
+					episodeChannel.Writer.TryWrite(asin);
+
+				items.AddRange(episodes);
+				items.AddRange(series);
+			}
+
+			var booksInBatch
+				= itemsBatch
+				.Where(i => !i.IsSeriesParent && !i.IsEpisodes)
+				.Where(i => i.IsAyce is not true || Configuration.Instance.ImportPlusTitles);
+			items.AddRange(booksInBatch);
 		}
 
-		private async Task<List<Item>> getItemsAsync(LibraryOptions libraryOptions, bool importEpisodes)
+		sw.Stop();
+		totalTime += sw.Elapsed;
+		Serilog.Log.Logger.Debug("Library scan complete after {elappsed_ms} ms. Found {count} books and series. Waiting on series episode scans to complete.", sw.ElapsedMilliseconds, items.Count);
+		sw.Restart();
+
+		//Signal that we're done adding asins
+		episodeChannel.Writer.Complete();
+
+		//Wait for all episodes/parents to be retrived
+		var allEps = await batchReaderTask;
+
+		sw.Stop();
+		totalTime += sw.Elapsed;
+		Serilog.Log.Logger.Debug("Episode scan complete after {elappsed_ms} ms. Found {count} episodes and series .", sw.ElapsedMilliseconds, allEps.Count);
+		sw.Restart();
+
+		Serilog.Log.Logger.Debug("Begin indexing series episodes");
+		items.AddRange(allEps);
+
+		//Set the Item.Series info for episodes and parents.
+		foreach (var parent in items.Where(i => i.IsSeriesParent))
 		{
-			Serilog.Log.Logger.Debug("Beginning library scan.");
+			var children = items.Where(i => i.IsEpisodes && i.Relationships?.Any(r => r.Asin == parent.Asin) is true);
+			SetSeries(parent, children);
+		}
 
-			List<Item> items = new();
+		int orphansRemoved = items.RemoveAll(i => (i.IsEpisodes || i.IsSeriesParent) && i.Series is null);
+		if (orphansRemoved > 0)
+			Serilog.Log.Debug("{orphansRemoved} podcast orphans not imported", orphansRemoved);
+
+		sw.Stop();
+		totalTime += sw.Elapsed;
+		Serilog.Log.Logger.Information("Completed indexing series episodes after {elappsed_ms} ms.", sw.ElapsedMilliseconds);
+		Serilog.Log.Logger.Information($"Completed library scan in {totalTime.TotalMilliseconds:F0} ms.");
+
+		Array.ForEach(ISanitizer.GetAllSanitizers(), s => s.Sanitize(items));
+		var allExceptions = IValidator.GetAllValidators().SelectMany(v => v.Validate(items)).ToList();
+		if (allExceptions?.Count > 0)
+			throw new ImportValidationException(items, allExceptions);
+
+		return items;
+	}
+
+	#region episodes and podcasts
+
+	/// <summary>
+	/// Read asins from the channel and request catalog item info in batches of <see cref="BatchSize"/>. Blocks until <paramref name="channelReader"/> is closed.
+	/// </summary>
+	/// <param name="channelReader">Input asins to batch</param>
+	/// <param name="semaphore">Shared semaphore to limit concurrency</param>
+	/// <returns>All <see cref="Item"/>s of asins written to the channel.</returns>
+	private async Task<List<Item>> readAllAsinsAsync(ChannelReader<string> channelReader, SemaphoreSlim semaphore)
+	{
+		int batchNum = 1;
+		List<Task<List<Item>>> getTasks = new();
+
+		while (await channelReader.WaitToReadAsync())
+		{
+			List<string> asins = new();
+
+			while (asins.Count < BatchSize && await channelReader.WaitToReadAsync())
+			{
+				var asin = await channelReader.ReadAsync();
+
+				if (!asins.Contains(asin))
+					asins.Add(asin);
+			}
+			await semaphore.WaitAsync();
+			getTasks.Add(getProductsAsync(batchNum++, asins, semaphore));
+		}
+
+		var completed = await Task.WhenAll(getTasks);
+		//We only want Series parents and Series episodes. Exclude other relationship types (e.g. 'season')
+		return completed.SelectMany(l => l).Where(i => i.IsSeriesParent || i.IsEpisodes).ToList();
+	}
+
+	private async Task<List<Item>> getProductsAsync(int batchNum, List<string> asins, SemaphoreSlim semaphore)
+	{
+		Serilog.Log.Logger.Debug($"Batch {batchNum} Begin: Fetching {asins.Count} asins");
+		try
+		{
 			var sw = Stopwatch.StartNew();
-			var totalTime = TimeSpan.Zero;
-			using var semaphore = new SemaphoreSlim(MaxConcurrency);
-
-			var episodeChannel = Channel.CreateUnbounded<string>(new UnboundedChannelOptions { SingleReader = true, SingleWriter = true });
-			var batchReaderTask = readAllAsinsAsync(episodeChannel.Reader, semaphore);
-
-			//Scan the library for all added books.
-			//Get relationship asins from episode-type items and write them to episodeChannel where they will be batched and queried.
-			await foreach (var item in Api.GetLibraryItemsPagesAsync(libraryOptions, BatchSize, semaphore))
-			{
-				if (importEpisodes)
-				{
-					var episodes = item.Where(i => i.IsEpisodes).ToList();
-					var series = item.Where(i => i.IsSeriesParent).ToList();
-
-					var parentAsins = episodes
-						.SelectMany(i => i.Relationships)
-						.Where(r => r.RelationshipToProduct == RelationshipToProduct.Parent)
-						.Select(r => r.Asin);
-
-					var episodeAsins = series
-						.SelectMany(i => i.Relationships)
-						.Where(r => r.RelationshipToProduct == RelationshipToProduct.Child && r.RelationshipType == RelationshipType.Episode)
-						.Select(r => r.Asin);
-
-					foreach (var asin in parentAsins.Concat(episodeAsins))
-						episodeChannel.Writer.TryWrite(asin);
-
-					items.AddRange(episodes);
-					items.AddRange(series);
-				}
-
-				items.AddRange(item.Where(i => !i.IsSeriesParent && !i.IsEpisodes));
-			}
-
+			var items = await Api.GetCatalogProductsAsync(asins, CatalogOptions.ResponseGroupOptions.Rating | CatalogOptions.ResponseGroupOptions.Media
+				| CatalogOptions.ResponseGroupOptions.Relationships | CatalogOptions.ResponseGroupOptions.ProductDesc
+				| CatalogOptions.ResponseGroupOptions.Contributors | CatalogOptions.ResponseGroupOptions.ProvidedReview
+				| CatalogOptions.ResponseGroupOptions.ProductPlans | CatalogOptions.ResponseGroupOptions.Series
+				| CatalogOptions.ResponseGroupOptions.CategoryLadders | CatalogOptions.ResponseGroupOptions.ProductExtendedAttrs);
 			sw.Stop();
-			totalTime += sw.Elapsed;
-			Serilog.Log.Logger.Debug("Library scan complete after {elappsed_ms} ms. Found {count} books and series. Waiting on series episode scans to complete.", sw.ElapsedMilliseconds, items.Count);
-			sw.Restart();
 
-			//Signal that we're done adding asins
-			episodeChannel.Writer.Complete();
-
-			//Wait for all episodes/parents to be retrived
-			var allEps = await batchReaderTask;
-
-			sw.Stop();
-			totalTime += sw.Elapsed;
-			Serilog.Log.Logger.Debug("Episode scan complete after {elappsed_ms} ms. Found {count} episodes and series .", sw.ElapsedMilliseconds, allEps.Count);
-			sw.Restart();
-
-			Serilog.Log.Logger.Debug("Begin indexing series episodes");
-			items.AddRange(allEps);
-
-			//Set the Item.Series info for episodes and parents.
-			foreach (var parent in items.Where(i => i.IsSeriesParent))
-			{
-				var children = items.Where(i => i.IsEpisodes && i.Relationships.Any(r => r.Asin == parent.Asin));
-				SetSeries(parent, children);
-			}
-
-			int orphansRemoved = items.RemoveAll(i => (i.IsEpisodes || i.IsSeriesParent) && i.Series is null);
-			if (orphansRemoved > 0)
-				Serilog.Log.Debug("{orphansRemoved} podcast orphans not imported", orphansRemoved);
-
-			sw.Stop();
-			totalTime += sw.Elapsed;
-			Serilog.Log.Logger.Information("Completed indexing series episodes after {elappsed_ms} ms.", sw.ElapsedMilliseconds);
-			Serilog.Log.Logger.Information($"Completed library scan in {totalTime.TotalMilliseconds:F0} ms.");
-
-			var allExceptions = IValidator.GetAllValidators().SelectMany(v => v.Validate(items)).ToList();
-			if (allExceptions?.Count > 0)
-				throw new ImportValidationException(items, allExceptions);
+			Serilog.Log.Logger.Debug($"Batch {batchNum} End: Retrieved {items.Count} items in {sw.ElapsedMilliseconds} ms");
 
 			return items;
 		}
-
-		#region episodes and podcasts
-
-		/// <summary>
-		/// Read asins from the channel and request catalog item info in batches of <see cref="BatchSize"/>. Blocks until <paramref name="channelReader"/> is closed.
-		/// </summary>
-		/// <param name="channelReader">Input asins to batch</param>
-		/// <param name="semaphore">Shared semaphore to limit concurrency</param>
-		/// <returns>All <see cref="Item"/>s of asins written to the channel.</returns>
-		private async Task<List<Item>> readAllAsinsAsync(ChannelReader<string> channelReader, SemaphoreSlim semaphore)
+		catch (Exception ex)
 		{
-			int batchNum = 1;
-			List<Task<List<Item>>> getTasks = new();
+			Serilog.Log.Logger.Error(ex, "Error fetching batch of episodes. {@DebugInfo}", new { asins });
+			throw;
+		}
+		finally { semaphore.Release(); }
+	}
 
-			while (await channelReader.WaitToReadAsync())
+	public static void SetSeries(Item parent, IEnumerable<Item> children)
+	{
+		ArgumentValidator.EnsureNotNull(parent, nameof(parent));
+		ArgumentValidator.EnsureNotNull(children, nameof(children));
+
+		//A series parent will always have exactly 1 Series
+		parent.Series = new[]
+		{
+			new Series
 			{
-				List<string> asins = new();
-
-				while (asins.Count < BatchSize && await channelReader.WaitToReadAsync())
-				{
-					var asin = await channelReader.ReadAsync();
-
-					if (!asins.Contains(asin))
-						asins.Add(asin);
-				}
-				await semaphore.WaitAsync();
-				getTasks.Add(getProductsAsync(batchNum++, asins, semaphore));
+				Asin = parent.Asin,
+				Sequence = "-1",
+				Title = parent.TitleWithSubtitle
 			}
+		};
 
-			var completed = await Task.WhenAll(getTasks);
-			//We only want Series parents and Series episodes. Explude other relationship types (e.g. 'season')
-			return completed.SelectMany(l => l).Where(i => i.IsSeriesParent || i.IsEpisodes).ToList();
+		if (parent.PurchaseDate == default)
+		{
+			parent.PurchaseDate = children.Select(c => c.PurchaseDate).Order().FirstOrDefault(d => d != default);
+
+			if (parent.PurchaseDate == default)
+			{
+				Serilog.Log.Logger.Warning("{series} doesn't have a purchase date. Using UtcNow", parent);
+				parent.PurchaseDate = DateTimeOffset.UtcNow;
+			}
 		}
 
-		private async Task<List<Item>> getProductsAsync(int batchNum, List<string> asins, SemaphoreSlim semaphore)
+		int lastEpNum = -1, dupeCount = 0;
+		foreach (var child in children.OrderBy(i => i.EpisodeNumber).ThenBy(i => i.PublicationDateTime))
 		{
-			Serilog.Log.Logger.Debug($"Batch {batchNum} Begin: Fetching {asins.Count} asins");
-			try
+			string sequence;
+			if (child.EpisodeNumber is null)
 			{
-				var sw = Stopwatch.StartNew();
-				var items = await Api.GetCatalogProductsAsync(asins, CatalogOptions.ResponseGroupOptions.Rating | CatalogOptions.ResponseGroupOptions.Media
-					| CatalogOptions.ResponseGroupOptions.Relationships | CatalogOptions.ResponseGroupOptions.ProductDesc
-					| CatalogOptions.ResponseGroupOptions.Contributors | CatalogOptions.ResponseGroupOptions.ProvidedReview
-					| CatalogOptions.ResponseGroupOptions.ProductPlans | CatalogOptions.ResponseGroupOptions.Series
-					| CatalogOptions.ResponseGroupOptions.CategoryLadders | CatalogOptions.ResponseGroupOptions.ProductExtendedAttrs);
-				sw.Stop();
-
-				Serilog.Log.Logger.Debug($"Batch {batchNum} End: Retrieved {items.Count} items in {sw.ElapsedMilliseconds} ms");
-
-				return items;
+				// This should properly be Single() not FirstOrDefault(), but FirstOrDefault is defensive for malformed data from audible
+				sequence = parent.Relationships?.FirstOrDefault(r => r.Asin == child.Asin)?.Sort?.ToString() ?? "0";
 			}
-			catch (Exception ex)
+			else
 			{
-				Serilog.Log.Logger.Error(ex, "Error fetching batch of episodes. {@DebugInfo}", new { asins });
-				throw;
+				//multipart episodes may have the same episode number
+				if (child.EpisodeNumber == lastEpNum)
+					dupeCount++;
+				else
+					lastEpNum = child.EpisodeNumber.Value;
+
+				sequence = (lastEpNum + dupeCount).ToString();
 			}
-			finally { semaphore.Release(); }
-		}
 
-		public static void SetSeries(Item parent, IEnumerable<Item> children)
-		{
-			ArgumentValidator.EnsureNotNull(parent, nameof(parent));
-			ArgumentValidator.EnsureNotNull(children, nameof(children));
-
-			//A series parent will always have exactly 1 Series
-			parent.Series = new[]
+			// use parent's 'DateAdded'. DateAdded is just a convenience prop for: PurchaseDate.UtcDateTime
+			child.PurchaseDate = parent.PurchaseDate;
+			// parent is essentially a series
+			child.Series = new[]
 			{
 				new Series
 				{
 					Asin = parent.Asin,
-					Sequence = "-1",
+					Sequence = sequence,
 					Title = parent.TitleWithSubtitle
 				}
 			};
-
-			if (parent.PurchaseDate == default)
-			{
-				parent.PurchaseDate = children.Select(c => c.PurchaseDate).Order().FirstOrDefault(d => d != default);
-
-				if (parent.PurchaseDate == default)
-				{
-					Serilog.Log.Logger.Warning("{series} doesn't have a purchase date. Using UtcNow", parent);
-					parent.PurchaseDate = DateTimeOffset.UtcNow;
-				}
-			}
-
-			int lastEpNum = -1, dupeCount = 0;
-			foreach (var child in children.OrderBy(i => i.EpisodeNumber).ThenBy(i => i.PublicationDateTime))
-			{
-				string sequence;
-				if (child.EpisodeNumber is null)
-				{
-					// This should properly be Single() not FirstOrDefault(), but FirstOrDefault is defensive for malformed data from audible
-					sequence = parent.Relationships.FirstOrDefault(r => r.Asin == child.Asin)?.Sort?.ToString() ?? "0";
-				}
-				else
-				{
-					//multipart episodes may have the same episode number
-					if (child.EpisodeNumber == lastEpNum)
-						dupeCount++;
-					else
-						lastEpNum = child.EpisodeNumber.Value;
-
-					sequence = (lastEpNum + dupeCount).ToString();
-				}
-
-				// use parent's 'DateAdded'. DateAdded is just a convenience prop for: PurchaseDate.UtcDateTime
-				child.PurchaseDate = parent.PurchaseDate;
-				// parent is essentially a series
-				child.Series = new[]
-				{
-					new Series
-					{
-						Asin = parent.Asin,
-						Sequence = sequence,
-						Title = parent.TitleWithSubtitle
-					}
-				};
-			}
 		}
-		#endregion
 	}
+	#endregion
 }

Source/AudibleUtilities/AudibleApiSanitizers.cs

@@ -0,0 +1,32 @@
+using AudibleApi.Common;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace AudibleUtilities;
+
+public interface ISanitizer
+{
+	void Sanitize(IEnumerable<Item> items);
+
+	public static ISanitizer[] GetAllSanitizers() => [
+		new ContributorSanitizer()
+	];
+}
+
+public class ContributorSanitizer : ISanitizer
+{
+	public void Sanitize(IEnumerable<Item> items)
+	{
+		foreach (var item in items)
+		{
+			item.Authors = SanitizePersonArray(item.Authors);
+			item.Narrators = SanitizePersonArray(item.Narrators);
+		}
+	}
+
+	private static Person[]? SanitizePersonArray(Person?[]? contributors)
+		=> contributors
+		?.OfType<Person>()
+		.Where(c => !string.IsNullOrWhiteSpace(c.Name))
+		.ToArray();
+}

Source/AudibleUtilities/AudibleApiStorage.cs

@@ -1,86 +1,85 @@
-using System;
-using System.IO;
-using LibationFileManager;
+using LibationFileManager;
 using Newtonsoft.Json;
+using System;
+using System.IO;
 
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+public class AccountSettingsLoadErrorEventArgs : ErrorEventArgs
 {
-	public class AccountSettingsLoadErrorEventArgs : ErrorEventArgs
+	/// <summary>
+	/// Create a new, empty <see cref="AccountsSettings"/> file if true, otherwise throw
+	/// </summary>
+	public bool Handled { get; set; }
+	/// <summary>
+	/// The file path of the AccountsSettings.json file
+	/// </summary>
+	public string SettingsFilePath { get; }
+
+	public AccountSettingsLoadErrorEventArgs(string path, Exception exception)
+		: base(exception)
 	{
-		/// <summary>
-		/// Create a new, empty <see cref="AccountsSettings"/> file if true, otherwise throw
-		/// </summary>
-		public bool Handled { get; set; }
-		/// <summary>
-		/// The file path of the AccountsSettings.json file
-		/// </summary>
-		public string SettingsFilePath { get; }
-
-		public AccountSettingsLoadErrorEventArgs(string path, Exception exception)
-			: base(exception)
-		{
-			SettingsFilePath = path;
-		}
-	}
-
-	public static class AudibleApiStorage
-	{
-		public static string AccountsSettingsFile => Path.Combine(Configuration.Instance.LibationFiles.Location, "AccountsSettings.json");
-
-		public static event EventHandler<AccountSettingsLoadErrorEventArgs> LoadError;
-
-		public static void EnsureAccountsSettingsFileExists()
-		{
-			// saves. BEWARE: this will overwrite an existing file
-			if (!File.Exists(AccountsSettingsFile))
-			{
-				//Save the JSON file manually so that AccountsSettingsPersister.Saving and AccountsSettingsPersister.Saved
-				//are not fired. There's no need to fire those events on an empty AccountsSettings file.
-				var accountSerializerSettings = AudibleApi.Authorization.Identity.GetJsonSerializerSettings();
-				File.WriteAllText(AccountsSettingsFile, JsonConvert.SerializeObject(new AccountsSettings(), Formatting.Indented, accountSerializerSettings));
-			}
-		}
-
-		/// <summary>If you use this, be a good citizen and DISPOSE of it</summary>
-		public static AccountsSettingsPersister GetAccountsSettingsPersister()
-		{
-			try
-			{
-				return new AccountsSettingsPersister(AccountsSettingsFile);
-			}
-			catch (Exception ex)
-			{
-				var args = new AccountSettingsLoadErrorEventArgs(AccountsSettingsFile, ex);
-				LoadError?.Invoke(null, args);
-				if (args.Handled)
-					return GetAccountsSettingsPersister();
-				throw;
-			}
-		}
-
-		public static string GetIdentityTokensJsonPath(this Account account)
-			=> GetIdentityTokensJsonPath(account.AccountId, account.Locale?.Name);
-		public static string GetIdentityTokensJsonPath(string username, string localeName)
-		{
-			var usernameSanitized = trimSurroundingQuotes(JsonConvert.ToString(username));
-			var localeNameSanitized = trimSurroundingQuotes(JsonConvert.ToString(localeName));
-
-			return $"$.Accounts[?(@.AccountId == '{usernameSanitized}' && @.IdentityTokens.LocaleName == '{localeNameSanitized}')].IdentityTokens";
-		}
-		private static string trimSurroundingQuotes(string str)
-		{
-			// SubString algo is better than .Trim("\"")
-			//   orig string  "
-			//   json string  "\""
-			// Eg:
-			//   =>           str.Trim("\"")
-			//   output       \
-			// vs
-			//   =>           str.Substring(1, str.Length - 2)
-			//   output       \"
-			// also works with surrounding single quotes
-
-			return str.Substring(1, str.Length - 2);
-		}
+		SettingsFilePath = path;
+	}
+}
+
+public static class AudibleApiStorage
+{
+	public static string AccountsSettingsFile => Path.Combine(Configuration.Instance.LibationFiles.Location, "AccountsSettings.json");
+
+	public static event EventHandler<AccountSettingsLoadErrorEventArgs>? LoadError;
+
+	public static void EnsureAccountsSettingsFileExists()
+	{
+		// saves. BEWARE: this will overwrite an existing file
+		if (!File.Exists(AccountsSettingsFile))
+		{
+			//Save the JSON file manually so that AccountsSettingsPersister.Saving and AccountsSettingsPersister.Saved
+			//are not fired. There's no need to fire those events on an empty AccountsSettings file.
+			var accountSerializerSettings = AudibleApi.Authorization.Identity.GetJsonSerializerSettings();
+			File.WriteAllText(AccountsSettingsFile, JsonConvert.SerializeObject(new AccountsSettings(), Formatting.Indented, accountSerializerSettings));
+		}
+	}
+
+	/// <summary>If you use this, be a good citizen and DISPOSE of it</summary>
+	public static AccountsSettingsPersister GetAccountsSettingsPersister()
+	{
+		try
+		{
+			return new AccountsSettingsPersister(AccountsSettingsFile);
+		}
+		catch (Exception ex)
+		{
+			var args = new AccountSettingsLoadErrorEventArgs(AccountsSettingsFile, ex);
+			LoadError?.Invoke(null, args);
+			if (args.Handled)
+				return GetAccountsSettingsPersister();
+			throw;
+		}
+	}
+
+	public static string GetIdentityTokensJsonPath(this Account account)
+		=> GetIdentityTokensJsonPath(account.AccountId, account.Locale?.Name);
+	public static string GetIdentityTokensJsonPath(string username, string? localeName)
+	{
+		var usernameSanitized = trimSurroundingQuotes(JsonConvert.ToString(username));
+		var localeNameSanitized = trimSurroundingQuotes(JsonConvert.ToString(localeName));
+
+		return $"$.Accounts[?(@.AccountId == '{usernameSanitized}' && @.IdentityTokens.LocaleName == '{localeNameSanitized}')].IdentityTokens";
+	}
+	private static string trimSurroundingQuotes(string str)
+	{
+		// SubString algo is better than .Trim("\"")
+		//   orig string  "
+		//   json string  "\""
+		// Eg:
+		//   =>           str.Trim("\"")
+		//   output       \
+		// vs
+		//   =>           str.Substring(1, str.Length - 2)
+		//   output       \"
+		// also works with surrounding single quotes
+
+		return str.Substring(1, str.Length - 2);
 	}
 }

Source/AudibleUtilities/AudibleApiValidators.cs

@@ -1,102 +1,91 @@
-using System;
+using AudibleApi.Common;
+using System;
 using System.Collections.Generic;
 using System.Linq;
-using AudibleApi.Common;
 
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+public interface IValidator
 {
-	public interface IValidator
+	IEnumerable<Exception> Validate(IEnumerable<Item> items);
+
+	public static IValidator[] GetAllValidators() => [
+		new LibraryValidator(),
+		new BookValidator(),
+		new CategoryValidator(),
+		new SeriesValidator(),
+	];
+}
+
+/// <summary>
+/// To be used when no validation is desired
+/// </summary>
+public class ClearValidator : IValidator
+{
+	public IEnumerable<Exception> Validate(IEnumerable<Item> items) => [];
+}
+public class LibraryValidator : IValidator
+{
+	public IEnumerable<Exception> Validate(IEnumerable<Item> items)
 	{
-		IEnumerable<Exception> Validate(IEnumerable<Item> items);
+		var exceptions = new List<Exception>();
 
-		public static IValidator[] GetAllValidators()
-			=> new IValidator[]
-			{
-				new LibraryValidator(),
-				new BookValidator(),
-				new CategoryValidator(),
-				new ContributorValidator(),
-				new SeriesValidator(),
-			};
-	}
+		if (items.Any(i => string.IsNullOrWhiteSpace(i.ProductId)))
+			exceptions.Add(new ArgumentException($"Collection contains item(s) with null or blank {nameof(Item.ProductId)}", nameof(items)));
+		//// unfortunately, an actual user has a title with a beginning-of-time 'purchase_date'
+		//if (items.Any(i => i.DateAdded < new DateTime(1980, 1, 1)))
+		//	exceptions.Add(new ArgumentException($"Collection contains item(s) with invalid {nameof(Item.DateAdded)}", nameof(items)));
 
-	public class LibraryValidator : IValidator
-	{
-		public IEnumerable<Exception> Validate(IEnumerable<Item> items)
-		{
-			var exceptions = new List<Exception>();
-
-			if (items.Any(i => string.IsNullOrWhiteSpace(i.ProductId)))
-				exceptions.Add(new ArgumentException($"Collection contains item(s) with null or blank {nameof(Item.ProductId)}", nameof(items)));
-            //// unfortunately, an actual user has a title with a beginning-of-time 'purchase_date'
-            //if (items.Any(i => i.DateAdded < new DateTime(1980, 1, 1)))
-            //	exceptions.Add(new ArgumentException($"Collection contains item(s) with invalid {nameof(Item.DateAdded)}", nameof(items)));
-
-            return exceptions;
-		}
-	}
-	public class BookValidator : IValidator
-	{
-		public IEnumerable<Exception> Validate(IEnumerable<Item> items)
-		{
-			var exceptions = new List<Exception>();
-
-			// a book having no authors is rare but allowed
-
-			if (items.Any(i => string.IsNullOrWhiteSpace(i.ProductId)))
-				exceptions.Add(new ArgumentException($"Collection contains item(s) with blank {nameof(Item.ProductId)}", nameof(items)));
-
-			// this can happen with podcast episodes
-			foreach (var i in items.Where(i => string.IsNullOrWhiteSpace(i.Title)))
-				i.Title = "[blank title]";
-
-			return exceptions;
-		}
-	}
-	public class CategoryValidator : IValidator
-	{
-		public IEnumerable<Exception> Validate(IEnumerable<Item> items)
-		{
-			var exceptions = new List<Exception>();
-
-			var distinct = items.GetCategoriesDistinct();
-			if (distinct.Any(s => s.CategoryId is null))
-				exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Categories)} with null {nameof(Ladder.CategoryId)}", nameof(items)));
-			if (distinct.Any(s => s.CategoryName is null))
-				exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Categories)} with null {nameof(Ladder.CategoryName)}", nameof(items)));
-
-			return exceptions;
-		}
-	}
-	public class ContributorValidator : IValidator
-	{
-		public IEnumerable<Exception> Validate(IEnumerable<Item> items)
-		{
-			var exceptions = new List<Exception>();
-
-			if (items.GetAuthorsDistinct().Any(a => string.IsNullOrWhiteSpace(a.Name)))
-				exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Authors)} with null {nameof(Person.Name)}", nameof(items)));
-			if (items.GetNarratorsDistinct().Any(a => string.IsNullOrWhiteSpace(a.Name)))
-				exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Narrators)} with null {nameof(Person.Name)}", nameof(items)));
-
-			return exceptions;
-		}
-	}
-	public class SeriesValidator : IValidator
-	{
-		public IEnumerable<Exception> Validate(IEnumerable<Item> items)
-		{
-			var exceptions = new List<Exception>();
-
-			var distinct = items.GetSeriesDistinct();
-			if (distinct.Any(s => s.SeriesId is null))
-				exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Series)} with null {nameof(Series.SeriesId)}", nameof(items)));
-
-			//// unfortunately, an actual user has a series with no name
-			//if (distinct.Any(s => s.SeriesName is null))
-			//    exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Series)} with null {nameof(Series.SeriesName)}", nameof(items)));
-
-			return exceptions;
-		}
+		return exceptions;
+	}
+}
+public class BookValidator : IValidator
+{
+	public IEnumerable<Exception> Validate(IEnumerable<Item> items)
+	{
+		var exceptions = new List<Exception>();
+
+		// a book having no authors is rare but allowed
+
+		if (items.Any(i => string.IsNullOrWhiteSpace(i.ProductId)))
+			exceptions.Add(new ArgumentException($"Collection contains item(s) with blank {nameof(Item.ProductId)}", nameof(items)));
+
+		// this can happen with podcast episodes
+		foreach (var i in items.Where(i => string.IsNullOrWhiteSpace(i.Title)))
+			i.Title = "[blank title]";
+
+		return exceptions;
+	}
+}
+public class CategoryValidator : IValidator
+{
+	public IEnumerable<Exception> Validate(IEnumerable<Item> items)
+	{
+		var exceptions = new List<Exception>();
+
+		var distinct = items.GetCategoriesDistinct();
+		if (distinct.Any(s => s.CategoryId is null))
+			exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Categories)} with null {nameof(Ladder.CategoryId)}", nameof(items)));
+		if (distinct.Any(s => s.CategoryName is null))
+			exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Categories)} with null {nameof(Ladder.CategoryName)}", nameof(items)));
+
+		return exceptions;
+	}
+}
+public class SeriesValidator : IValidator
+{
+	public IEnumerable<Exception> Validate(IEnumerable<Item> items)
+	{
+		var exceptions = new List<Exception>();
+
+		var distinct = items.GetSeriesDistinct();
+		if (distinct.Any(s => s.SeriesId is null))
+			exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Series)} with null {nameof(Series.SeriesId)}", nameof(items)));
+
+		//// unfortunately, an actual user has a series with no name
+		//if (distinct.Any(s => s.SeriesName is null))
+		//    exceptions.Add(new ArgumentException($"Collection contains {nameof(Item.Series)} with null {nameof(Series.SeriesName)}", nameof(items)));
+
+		return exceptions;
 	}
 }

Source/AudibleUtilities/AudibleUtilities.csproj

@@ -2,11 +2,12 @@
 
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="AudibleApi" Version="10.1.0.1" />
-    <PackageReference Include="Google.Protobuf" Version="3.33.1" />
+    <PackageReference Include="AudibleApi" Version="10.1.5.1" />
+    <PackageReference Include="Google.Protobuf" Version="3.34.1" />
   </ItemGroup>
 
   <ItemGroup>

Source/AudibleUtilities/Extensions.cs

@@ -0,0 +1,24 @@
+using AudibleApi.Common;
+using System;
+using System.Linq;
+
+namespace AudibleUtilities;
+
+public static class Extensions
+{
+	extension(Item item)
+	{
+		/// <summary>
+		/// Determines when your audible plus or free book will expire from your library  
+		/// plan.IsAyce from underlying AudibleApi project determines the plans to look at, first plan found is used.
+		/// In some cases current date is later than end date so exclude.
+		/// </summary>
+		/// <returns>The DateTime that this title will become unavailable, otherwise null</returns>
+		public DateTime? GetExpirationDate()
+			  => item.Plans
+			  ?.Where(p => p.IsAyce)
+			  .Select(p => p.EndDate)
+			  .FirstOrDefault(end => end.HasValue && end.Value.Year is not (2099 or 9999) && end.Value.LocalDateTime >= DateTime.Now)
+			  ?.DateTime;
+	}
+}

Source/AudibleUtilities/ImportValidationException.cs

@@ -2,14 +2,13 @@
 using System;
 using System.Collections.Generic;
 
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+public class ImportValidationException : AggregateException
 {
-	public class ImportValidationException : AggregateException
+	public List<Item> Items { get; }
+	public ImportValidationException(List<Item> items, IEnumerable<Exception> exceptions) : base(exceptions)
 	{
-		public List<Item> Items { get; }
-		public ImportValidationException(List<Item> items, IEnumerable<Exception> exceptions) : base(exceptions)
-		{
-			Items = items;
-		}
+		Items = items;
 	}
 }

Source/AudibleUtilities/Mkb79Auth.cs

@@ -1,205 +1,281 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
-using AudibleApi;
+using AudibleApi;
 using AudibleApi.Authorization;
 using AudibleApi.Cryptography;
 using Dinah.Core;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
 
-namespace AudibleUtilities
+namespace AudibleUtilities;
+
+public partial class Mkb79Auth : IIdentityMaintainer
 {
-	public partial class Mkb79Auth : IIdentityMaintainer
+	[JsonProperty("website_cookies")]
+	private JObject? _websiteCookies { get; set; }
+
+	[JsonProperty("adp_token")]
+	public string? AdpToken { get; private set; }
+
+	[JsonProperty("access_token")]
+	public string? AccessToken { get; private set; }
+
+	[JsonProperty("refresh_token")]
+	public string? RefreshToken { get; private set; }
+
+	[JsonProperty("device_private_key")]
+	public string? DevicePrivateKey { get; private set; }
+
+	[JsonProperty("store_authentication_cookie")]
+	private JObject? _storeAuthenticationCookie { get; set; }
+
+	[JsonProperty("device_info")]
+	public DeviceInfo? DeviceInfo { get; private set; }
+
+	[JsonProperty("customer_info")]
+	public CustomerInfo? CustomerInfo { get; private set; }
+
+	[JsonProperty("expires")]
+	private double _expires { get; set; }
+
+	[JsonProperty("locale_code")]
+	public string? LocaleCode { get; private set; }
+
+	[JsonProperty("with_username")]
+	public bool WithUsername { get; private set; }
+
+	[JsonProperty("activation_bytes")]
+	public string? ActivationBytes { get; private set; }
+
+	[JsonIgnore]
+	public Dictionary<string, string?>? WebsiteCookies
 	{
-		[JsonProperty("website_cookies")]
-		private JObject _websiteCookies { get; set; }
-	   
-		[JsonProperty("adp_token")]
-		public string AdpToken { get; private set; }
-
-		[JsonProperty("access_token")]
-		public string AccessToken { get; private set; }
-
-		[JsonProperty("refresh_token")]
-		public string RefreshToken { get; private set; }
-
-		[JsonProperty("device_private_key")]
-		public string DevicePrivateKey { get; private set; }
-
-		[JsonProperty("store_authentication_cookie")]
-		private JObject _storeAuthenticationCookie { get; set; }
-
-		[JsonProperty("device_info")]
-		public DeviceInfo DeviceInfo { get; private set; }
-
-		[JsonProperty("customer_info")]
-		public CustomerInfo CustomerInfo { get; private set; }
-
-		[JsonProperty("expires")]
-		private double _expires { get; set; }
-
-		[JsonProperty("locale_code")]
-		public string LocaleCode { get; private set; }
-
-		[JsonProperty("with_username")]
-		public bool WithUsername { get; private set; }
-
-		[JsonProperty("activation_bytes")]
-		public string ActivationBytes { get; private set; }
-
-		[JsonIgnore]
-		public Dictionary<string, string> WebsiteCookies
-		{
-			get => _websiteCookies.ToObject<Dictionary<string, string>>();
-			private set => _websiteCookies = JObject.Parse(JsonConvert.SerializeObject(value, Converter.Settings));
-		}
-
-		[JsonIgnore]
-		public string StoreAuthenticationCookie
-		{
-			get => _storeAuthenticationCookie.ToObject<Dictionary<string, string>>()["cookie"];
-			private set => _storeAuthenticationCookie = JObject.Parse(JsonConvert.SerializeObject(new Dictionary<string, string>() { { "cookie", value } }, Converter.Settings));
-		}
-
-		[JsonIgnore]
-		public DateTime AccessTokenExpires
-		{
-			get => DateTimeOffset.FromUnixTimeMilliseconds((long)(_expires * 1000)).DateTime;
-			private set => _expires = new DateTimeOffset(value).ToUnixTimeMilliseconds() / 1000d;
-		}
-
-		[JsonIgnore] public ISystemDateTime SystemDateTime { get; } = new SystemDateTime();
-		[JsonIgnore]
-		public Locale Locale => Localization.Locales.Where(l => l.WithUsername == WithUsername).Single(l => l.CountryCode == LocaleCode);
-		[JsonIgnore] public string DeviceSerialNumber => DeviceInfo.DeviceSerialNumber;
-		[JsonIgnore] public string DeviceType => DeviceInfo.DeviceType;
-		[JsonIgnore] public string AmazonAccountId => CustomerInfo.UserId;
-
-		public Task<AccessToken> GetAccessTokenAsync()
-			=> Task.FromResult(new AccessToken(AccessToken, AccessTokenExpires));
-
-		public Task<AdpToken> GetAdpTokenAsync() 
-			=> Task.FromResult(new AdpToken(AdpToken));
-
-		public Task<PrivateKey> GetPrivateKeyAsync() 
-			=> Task.FromResult(new PrivateKey(DevicePrivateKey));
+		get => _websiteCookies?.ToObject<Dictionary<string, string?>>();
+		private set => _websiteCookies = value is null || value.Count == 0
+			? null
+			: JObject.Parse(JsonConvert.SerializeObject(value, Converter.Settings));
 	}
 
-	public partial class CustomerInfo
+	[JsonIgnore]
+	public string? StoreAuthenticationCookie
 	{
-		[JsonProperty("account_pool")]
-		public string AccountPool { get; set; }
-
-		[JsonProperty("user_id")]
-		public string UserId { get; set; }
-
-		[JsonProperty("home_region")]
-		public string HomeRegion { get; set; }
-
-		[JsonProperty("name")]
-		public string Name { get; set; }
-
-		[JsonProperty("given_name")]
-		public string GivenName { get; set; }
+		get => _storeAuthenticationCookie?.ToObject<Dictionary<string, string>>()?["cookie"];
+		private set => _storeAuthenticationCookie = JObject.Parse(JsonConvert.SerializeObject(new Dictionary<string, string>() { { "cookie", value ?? "" } }, Converter.Settings));
 	}
 
-	public partial class DeviceInfo
+	[JsonIgnore]
+	public DateTime AccessTokenExpires
 	{
-		[JsonProperty("device_name")]
-		public string DeviceName { get; set; }
-
-		[JsonProperty("device_serial_number")]
-		public string DeviceSerialNumber { get; set; }
-
-		[JsonProperty("device_type")]
-		public string DeviceType { get; set; }
+		get => DateTimeOffset.FromUnixTimeMilliseconds((long)(_expires * 1000)).DateTime;
+		private set => _expires = new DateTimeOffset(value).ToUnixTimeMilliseconds() / 1000d;
 	}
 
-	public partial class Mkb79Auth
-	{
-		public static Mkb79Auth FromJson(string json)
-			=> JsonConvert.DeserializeObject<Mkb79Auth>(json, Converter.Settings);
+	[JsonIgnore] public ISystemDateTime SystemDateTime { get; } = new SystemDateTime();
+	[JsonIgnore]
+	public Locale Locale => Localization.Locales.Where(l => l.WithUsername == WithUsername).Single(l => l.CountryCode == LocaleCode);
+	[JsonIgnore] public string? DeviceSerialNumber => DeviceInfo?.DeviceSerialNumber;
+	[JsonIgnore] public string? DeviceType => DeviceInfo?.DeviceType;
+	[JsonIgnore] public string? AmazonAccountId => CustomerInfo?.UserId;
 
-		public string ToJson()
-			=> JObject.Parse(JsonConvert.SerializeObject(this, Converter.Settings)).ToString(Formatting.Indented);
+	public Task<AccessToken?> GetAccessTokenAsync()
+		=> AccessToken is null ? Task.FromResult((AccessToken?)null) : Task.FromResult((AccessToken?)new AccessToken(AccessToken, AccessTokenExpires));
 
-		public async Task<Account> ToAccountAsync()
-		{
-			var refreshToken = new RefreshToken(RefreshToken);
+	public Task<AdpToken?> GetAdpTokenAsync()
+		=> AdpToken is null ? Task.FromResult((AdpToken?)null) : Task.FromResult((AdpToken?)new AdpToken(AdpToken));
 
-			var authorize = new Authorize(Locale);
-			var newToken = await authorize.RefreshAccessTokenAsync(refreshToken);
-			AccessToken = newToken.TokenValue;
-			AccessTokenExpires = newToken.Expires;
-
-			var api = new Api(this);
-			var email = await api.GetEmailAsync();
-			var account = new Account(email)
-			{
-				DecryptKey = ActivationBytes,
-				AccountName = $"{email} - {Locale.Name}",
-				IdentityTokens = new Identity(Locale)
-			};
-
-			account.IdentityTokens.Update(
-				await GetPrivateKeyAsync(),
-				await GetAdpTokenAsync(),
-				await GetAccessTokenAsync(),
-				refreshToken,
-				WebsiteCookies.Select(c => new KeyValuePair<string, string>(c.Key, c.Value)),
-				DeviceSerialNumber,
-				DeviceType,
-				AmazonAccountId,
-				DeviceInfo.DeviceName,
-				StoreAuthenticationCookie);
-
-			return account;
-		}
-
-		public static Mkb79Auth FromAccount(Account account)
-			=> new()
-			{
-				AccessToken = account.IdentityTokens.ExistingAccessToken.TokenValue,
-				ActivationBytes = string.IsNullOrEmpty(account.DecryptKey) ? null : account.DecryptKey,
-				AdpToken = account.IdentityTokens.AdpToken.Value,
-				CustomerInfo = new CustomerInfo
-				{
-					AccountPool = "Amazon",
-					GivenName = string.Empty,
-					HomeRegion = "NA",
-					Name = string.Empty,
-					UserId = account.IdentityTokens.AmazonAccountId
-				},
-				DeviceInfo = new DeviceInfo
-				{
-					DeviceName = account.IdentityTokens.DeviceName,
-					DeviceSerialNumber = account.IdentityTokens.DeviceSerialNumber,
-					DeviceType = account.IdentityTokens.DeviceType,
-				},
-				DevicePrivateKey = account.IdentityTokens.PrivateKey,
-				AccessTokenExpires = account.IdentityTokens.ExistingAccessToken.Expires,
-				LocaleCode = account.Locale.CountryCode,
-				WithUsername = account.Locale.WithUsername,
-				RefreshToken = account.IdentityTokens.RefreshToken.Value,				
-				StoreAuthenticationCookie = account.IdentityTokens.StoreAuthenticationCookie,
-				WebsiteCookies = new(account.IdentityTokens.Cookies),
-			};
-	}
-
-	public static class Serialize
-	{
-		public static string ToJson(this Mkb79Auth self) 
-			=> JObject.Parse(JsonConvert.SerializeObject(self, Converter.Settings)).ToString(Formatting.Indented);
-	}
-
-	internal static class Converter
-	{
-		public static readonly JsonSerializerSettings Settings = new JsonSerializerSettings
-		{
-			MetadataPropertyHandling = MetadataPropertyHandling.Ignore,
-			DateParseHandling = DateParseHandling.None,
-		};
-	}
+	public Task<PrivateKey?> GetPrivateKeyAsync()
+		=> DevicePrivateKey is null ? Task.FromResult((PrivateKey?)null) : Task.FromResult((PrivateKey?)new PrivateKey(DevicePrivateKey));
+}
+
+public partial class CustomerInfo
+{
+	[JsonProperty("account_pool")]
+	public string? AccountPool { get; set; }
+
+	[JsonProperty("user_id")]
+	public string? UserId { get; set; }
+
+	[JsonProperty("home_region")]
+	public string? HomeRegion { get; set; }
+
+	[JsonProperty("name")]
+	public string? Name { get; set; }
+
+	[JsonProperty("given_name")]
+	public string? GivenName { get; set; }
+}
+
+public partial class DeviceInfo
+{
+	[JsonProperty("device_name")]
+	public string? DeviceName { get; set; }
+
+	[JsonProperty("device_serial_number")]
+	public string? DeviceSerialNumber { get; set; }
+
+	[JsonProperty("device_type")]
+	public string? DeviceType { get; set; }
+}
+
+public partial class Mkb79Auth
+{
+	public static Mkb79Auth? FromJson(string json)
+		=> JsonConvert.DeserializeObject<Mkb79Auth>(json, Converter.Settings);
+
+	public string ToJson()
+	{
+		var jo = JObject.Parse(JsonConvert.SerializeObject(this, Converter.Settings));
+		ApplyAudibleCliExportConventions(jo);
+		return jo.ToString(Formatting.Indented);
+	}
+
+	/// <summary>
+	/// audible-cli expects <c>website_cookies</c> as JSON null when empty (not <c>{}</c>) and a PEM
+	/// <c>device_private_key</c> with standard 64-character base64 lines and newline separators.
+	/// </summary>
+	internal static void ApplyAudibleCliExportConventions(JObject jo)
+	{
+		if (jo["website_cookies"] is JObject wc && !wc.Properties().Any())
+			jo["website_cookies"] = JValue.CreateNull();
+
+		if (jo["device_private_key"]?.Type == JTokenType.String)
+		{
+			var s = jo["device_private_key"]!.Value<string>();
+			var formatted = FormatDevicePrivateKeyForAudibleCliExport(s);
+			if (formatted is not null)
+				jo["device_private_key"] = formatted;
+		}
+	}
+
+	private static string? FormatDevicePrivateKeyForAudibleCliExport(string? value)
+	{
+		if (string.IsNullOrWhiteSpace(value))
+			return value;
+
+		var trimmed = value.Trim();
+		string payload;
+		if (trimmed.StartsWith(PrivateKey.REQUIRED_BEGINNING, StringComparison.Ordinal))
+		{
+			var endIdx = trimmed.LastIndexOf(PrivateKey.REQUIRED_ENDING, StringComparison.Ordinal);
+			if (endIdx < PrivateKey.REQUIRED_BEGINNING.Length)
+				return value;
+
+			payload = trimmed
+				.Substring(PrivateKey.REQUIRED_BEGINNING.Length, endIdx - PrivateKey.REQUIRED_BEGINNING.Length)
+				.Replace("\r", "")
+				.Replace("\n", "")
+				.Replace("\\n", "", StringComparison.Ordinal)
+				.Trim();
+		}
+		else
+			payload = trimmed;
+
+		if (payload.Length == 0)
+			return value;
+
+		try
+		{
+			Convert.FromBase64String(payload);
+		}
+		catch (FormatException)
+		{
+			return value;
+		}
+
+		var sb = new StringBuilder();
+		sb.Append(PrivateKey.REQUIRED_BEGINNING).Append('\n');
+		for (var i = 0; i < payload.Length; i += 64)
+		{
+			var len = Math.Min(64, payload.Length - i);
+			sb.Append(payload, i, len).Append('\n');
+		}
+		sb.Append(PrivateKey.REQUIRED_ENDING).Append('\n');
+		return sb.ToString();
+	}
+
+	public async Task<Account> ToAccountAsync()
+	{
+		if (RefreshToken is null)
+			throw new InvalidOperationException("Cannot create Account from Mkb79Auth without a Refresh Token.");
+		if (await GetAdpTokenAsync() is not { } adpToken)
+			throw new InvalidOperationException("Cannot create Account from Mkb79Auth without an ADP Token.");
+		if (await GetPrivateKeyAsync() is not { } privateKey)
+			throw new InvalidOperationException("Cannot create Account from Mkb79Auth without a Private Key.");
+		var refreshToken = new RefreshToken(RefreshToken);
+
+		var authorize = new Authorize(Locale);
+		var newToken = await authorize.RefreshAccessTokenAsync(refreshToken);
+		AccessToken = newToken.TokenValue;
+		AccessTokenExpires = newToken.Expires;
+
+		var api = new Api(this);
+		var email = await api.GetEmailAsync();
+		var account = new Account(email)
+		{
+			DecryptKey = ActivationBytes,
+			AccountName = $"{email} - {Locale.Name}",
+			IdentityTokens = new Identity(Locale),
+			LibraryScan = true,
+		};
+
+		account.IdentityTokens.Update(
+			privateKey,
+			adpToken,
+			newToken,
+			refreshToken,
+			WebsiteCookies?.Select(c => new KeyValuePair<string, string?>(c.Key, c.Value)),
+			DeviceSerialNumber,
+			DeviceType,
+			AmazonAccountId,
+			DeviceInfo?.DeviceName,
+			StoreAuthenticationCookie);
+
+		return account;
+	}
+
+	public static Mkb79Auth FromAccount(Account account)
+		=> new()
+		{
+			AccessToken = account.IdentityTokens?.ExistingAccessToken.TokenValue,
+			ActivationBytes = string.IsNullOrEmpty(account.DecryptKey) ? null : account.DecryptKey,
+			AdpToken = account.IdentityTokens?.AdpToken?.Value,
+			CustomerInfo = new CustomerInfo
+			{
+				AccountPool = "Amazon",
+				GivenName = string.Empty,
+				HomeRegion = "NA",
+				Name = string.Empty,
+				UserId = account.IdentityTokens?.AmazonAccountId
+			},
+			DeviceInfo = new DeviceInfo
+			{
+				DeviceName = account.IdentityTokens?.DeviceName,
+				DeviceSerialNumber = account.IdentityTokens?.DeviceSerialNumber,
+				DeviceType = account.IdentityTokens?.DeviceType,
+			},
+			DevicePrivateKey = account.IdentityTokens?.PrivateKey?.Value,
+			AccessTokenExpires = account.IdentityTokens?.ExistingAccessToken.Expires ?? default,
+			LocaleCode = account.Locale?.CountryCode,
+			WithUsername = account.Locale?.WithUsername ?? false,
+			RefreshToken = account.IdentityTokens?.RefreshToken?.Value,
+			StoreAuthenticationCookie = account.IdentityTokens?.StoreAuthenticationCookie,
+			WebsiteCookies = new(account.IdentityTokens?.Cookies ?? []),
+		};
+}
+
+public static class Serialize
+{
+	public static string ToJson(this Mkb79Auth self) => self.ToJson();
+}
+
+internal static class Converter
+{
+	public static readonly JsonSerializerSettings Settings = new JsonSerializerSettings
+	{
+		MetadataPropertyHandling = MetadataPropertyHandling.Ignore,
+		DateParseHandling = DateParseHandling.None,
+	};
 }

Source/AudibleUtilities/Mkb79AuthImporter.cs

@@ -0,0 +1,44 @@
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace AudibleUtilities;
+
+public enum Mkb79ImportOutcome
+{
+	Success,
+	DuplicateAccount,
+	InvalidFile,
+}
+
+public sealed record Mkb79ImportResult(Mkb79ImportOutcome Outcome, Account? Account = null, string? Message = null);
+
+public static class Mkb79AuthImporter
+{
+	/// <summary>
+	/// Deserialize mkb79/audible-cli JSON, refresh tokens, and add the account if not already present.
+	/// </summary>
+	public static async Task<Mkb79ImportResult> ImportFromJsonTextAsync(string jsonText)
+	{
+		var mkbAuth = Mkb79Auth.FromJson(jsonText);
+		if (mkbAuth is null)
+		{
+			return new Mkb79ImportResult(
+				Mkb79ImportOutcome.InvalidFile,
+				null,
+				"File did not contain valid mkb79/audible-cli account data.");
+		}
+
+		var account = await mkbAuth.ToAccountAsync();
+
+		using var persister = AudibleApiStorage.GetAccountsSettingsPersister();
+
+		if (persister.AccountsSettings.Accounts.Any(a =>
+				a.AccountId == account.AccountId && a.IdentityTokens?.Locale.Name == account.Locale?.Name))
+		{
+			return new Mkb79ImportResult(Mkb79ImportOutcome.DuplicateAccount, account);
+		}
+
+		persister.AccountsSettings.Add(account);
+		return new Mkb79ImportResult(Mkb79ImportOutcome.Success, account);
+	}
+}

Source/AudibleUtilities/Widevine/Cdm.Api.cs

@@ -1,15 +1,14 @@
 using AudibleApi;
+using AudibleApi.Cryptography;
+using Dinah.Core.Net.Http;
+using Newtonsoft.Json.Linq;
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Threading.Tasks;
 using System.Net.Http;
-using AudibleApi.Cryptography;
-using Newtonsoft.Json.Linq;
-using Dinah.Core.Net.Http;
 using System.Text.Json.Nodes;
+using System.Threading.Tasks;
 
-#nullable enable
 namespace AudibleUtilities.Widevine;
 
 public partial class Cdm
@@ -23,7 +22,7 @@ public partial class Cdm
 		using var persister = AudibleApiStorage.GetAccountsSettingsPersister();
 
 		//Check if there are any Android accounts. If not, we can't use Widevine.
-		if (!persister.Target.Accounts.Any(a => a.IdentityTokens.DeviceType == Resources.DeviceType))
+		if (!persister.Target.Accounts.Any(a => a.IdentityTokens?.DeviceType == Resources.DeviceType))
 			return null;
 
 		if (!string.IsNullOrEmpty(persister.Target.Cdm))
@@ -49,7 +48,7 @@ public partial class Cdm
 
 			//try to get a CDM file for any account that's registered as an android device.
 			//CDMs are not account-specific, so it doesn't matter which account we're successful with.
-			foreach (var account in persister.Target.Accounts.Where(a => a.IdentityTokens.DeviceType == Resources.DeviceType))
+			foreach (var account in persister.Target.Accounts.Where(a => a.IdentityTokens?.DeviceType == Resources.DeviceType))
 			{
 				try
 				{
@@ -112,7 +111,7 @@ public partial class Cdm
 			var uris = urlArray.Select(u => u.Value<string>()).OfType<string>().Select(u => new Uri(u)).ToArray();
 
 			if (uris.Length == 0)
-				throw  new System.IO.InvalidDataException("No CDM url found in JSON: " + fileContents);
+				throw new System.IO.InvalidDataException("No CDM url found in JSON: " + fileContents);
 
 			return uris;
 		}
@@ -174,7 +173,13 @@ public partial class Cdm
 	{
 		const string ACCOUNT_INFO_PATH = "/1.0/account/information";
 
+		if (account?.Locale is null)
+			throw new ArgumentException("Account does not have a valid locale.", nameof(account));
+		if (account.IdentityTokens?.AdpToken is null || account.IdentityTokens.PrivateKey is null)
+			throw new ArgumentException("Account does not have valid identity tokens.", nameof(account));
+
 		var message = new HttpRequestMessage(HttpMethod.Get, ACCOUNT_INFO_PATH);
+
 		message.SignRequest(
 					DateTime.UtcNow,
 					account.IdentityTokens.AdpToken,

Source/AudibleUtilities/Widevine/Cdm.cs

@@ -7,7 +7,6 @@ using System.Linq;
 using System.Security.Cryptography;
 using System.Text;
 
-#nullable enable
 namespace AudibleUtilities.Widevine;
 
 public enum KeyType
@@ -40,7 +39,7 @@ public enum KeyType
 
 public interface ISession : IDisposable
 {
-	string? GetLicenseChallenge(MpegDash dash);
+	string GetLicenseChallenge(MpegDash dash);
 	WidevineKey[] ParseLicense(string licenseMessage);
 }
 
@@ -107,10 +106,10 @@ public partial class Cdm
 				Cdm.Sessions.TryRemove(Id, out var session);
 		}
 
-		public string? GetLicenseChallenge(MpegDash dash)
+		public string GetLicenseChallenge(MpegDash dash)
 		{
 			if (!dash.TryGetPssh(Cdm.WidevineContentProtection, out var pssh))
-				return null;
+				throw new InvalidDataException("No Widevine PSSH found in DASH");
 
 			var licRequest = new LicenseRequest
 			{
@@ -192,7 +191,7 @@ public partial class Cdm
 					id = id.Append(new byte[16 - id.Length]);
 				}
 
-				keys[i] = new WidevineKey(new Guid(id,bigEndian: true), keyContainer.Type, keyBytes);
+				keys[i] = new WidevineKey(new Guid(id, bigEndian: true), keyContainer.Type, keyBytes);
 			}
 			return keys;
 		}

Source/AudibleUtilities/Widevine/Device.cs

@@ -3,7 +3,6 @@ using System.IO;
 using System.Numerics;
 using System.Security.Cryptography;
 
-#nullable enable
 namespace AudibleUtilities.Widevine;
 
 internal enum DeviceTypes : byte
@@ -35,10 +34,6 @@ internal class Device
 
 		if (FileVersion != 2)
 			throw new InvalidDataException($"Unknown CDM File Version: '{FileVersion}'");
-		if (Type != DeviceTypes.Android)
-			throw new InvalidDataException($"Unknown CDM Type: '{Type}'");
-		if (SecurityLevel != 3)
-			throw new InvalidDataException($"Unknown CDM Security Level: '{SecurityLevel}'");
 
 		var privateKeyLength = (fileData[7] << 8) | fileData[8];
 
@@ -70,11 +65,11 @@ internal class Device
 	public byte[] DecryptSessionKey(byte[] sessionKey)
 		=> CdmKey.Decrypt(sessionKey, RSAEncryptionPadding.OaepSHA1);
 
-    /// <summary>
-    /// Completely managed implementation of RSASSA-PSS using SHA-1.
-    /// https://github.com/bcgit/bc-csharp/blob/master/crypto/src/crypto/signers/PssSigner.cs
-    /// 
-    /// Absolutely nobody anywhere should use this RSASSA-PSS implementation in anything where they care about security at all. We completely skipped the random salt part of it because libation doesn't need security; it only needs to satisfy Audible server's challenge-response requirements.
+	/// <summary>
+	/// Completely managed implementation of RSASSA-PSS using SHA-1.
+	/// https://github.com/bcgit/bc-csharp/blob/master/crypto/src/crypto/signers/PssSigner.cs
+	/// 
+	/// Absolutely nobody anywhere should use this RSASSA-PSS implementation in anything where they care about security at all. We completely skipped the random salt part of it because libation doesn't need security; it only needs to satisfy Audible server's challenge-response requirements.
 	/// </summary>
 	private static class PssSha1Signer
 	{

Source/AudibleUtilities/Widevine/Extensions.cs

@@ -1,6 +1,5 @@
 using System;
 
-#nullable enable
 namespace AudibleUtilities.Widevine;
 
 internal static class Extensions

Source/AudibleUtilities/Widevine/MpegDash.cs

@@ -6,7 +6,6 @@ using System.Xml;
 using System.Xml.Linq;
 using System.Xml.XPath;
 
-#nullable enable
 namespace AudibleUtilities.Widevine;
 
 public class MpegDash

Source/DataLayer.Postgres/DataLayer.Postgres.csproj

@@ -9,11 +9,11 @@
     <OutputType>Library</OutputType>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0">
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.7">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0">
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.7">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

Source/DataLayer.Postgres/Migrations/20251027224441_InitialPostgres.cs

@@ -1,372 +1,369 @@
-using System;
-using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Migrations;
 using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+using System;
 
-#nullable disable
+namespace DataLayer.Postgres.Migrations;
 
-namespace DataLayer.Postgres.Migrations
+/// <inheritdoc />
+public partial class InitialPostgres : Migration
 {
-    /// <inheritdoc />
-    public partial class InitialPostgres : Migration
-    {
-        /// <inheritdoc />
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "Books",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(type: "integer", nullable: false)
-                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
-                    AudibleProductId = table.Column<string>(type: "text", nullable: true),
-                    Title = table.Column<string>(type: "text", nullable: true),
-                    Subtitle = table.Column<string>(type: "text", nullable: true),
-                    Description = table.Column<string>(type: "text", nullable: true),
-                    LengthInMinutes = table.Column<int>(type: "integer", nullable: false),
-                    ContentType = table.Column<int>(type: "integer", nullable: false),
-                    Locale = table.Column<string>(type: "text", nullable: true),
-                    PictureId = table.Column<string>(type: "text", nullable: true),
-                    PictureLarge = table.Column<string>(type: "text", nullable: true),
-                    IsAbridged = table.Column<bool>(type: "boolean", nullable: false),
-                    IsSpatial = table.Column<bool>(type: "boolean", nullable: false),
-                    DatePublished = table.Column<DateTime>(type: "timestamp without time zone", nullable: true),
-                    Language = table.Column<string>(type: "text", nullable: true),
-                    Rating_OverallRating = table.Column<float>(type: "real", nullable: true),
-                    Rating_PerformanceRating = table.Column<float>(type: "real", nullable: true),
-                    Rating_StoryRating = table.Column<float>(type: "real", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Books", x => x.BookId);
-                });
+	/// <inheritdoc />
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.CreateTable(
+			name: "Books",
+			columns: table => new
+			{
+				BookId = table.Column<int>(type: "integer", nullable: false)
+					.Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+				AudibleProductId = table.Column<string>(type: "text", nullable: true),
+				Title = table.Column<string>(type: "text", nullable: true),
+				Subtitle = table.Column<string>(type: "text", nullable: true),
+				Description = table.Column<string>(type: "text", nullable: true),
+				LengthInMinutes = table.Column<int>(type: "integer", nullable: false),
+				ContentType = table.Column<int>(type: "integer", nullable: false),
+				Locale = table.Column<string>(type: "text", nullable: true),
+				PictureId = table.Column<string>(type: "text", nullable: true),
+				PictureLarge = table.Column<string>(type: "text", nullable: true),
+				IsAbridged = table.Column<bool>(type: "boolean", nullable: false),
+				IsSpatial = table.Column<bool>(type: "boolean", nullable: false),
+				DatePublished = table.Column<DateTime>(type: "timestamp without time zone", nullable: true),
+				Language = table.Column<string>(type: "text", nullable: true),
+				Rating_OverallRating = table.Column<float>(type: "real", nullable: true),
+				Rating_PerformanceRating = table.Column<float>(type: "real", nullable: true),
+				Rating_StoryRating = table.Column<float>(type: "real", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Books", x => x.BookId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Categories",
-                columns: table => new
-                {
-                    CategoryId = table.Column<int>(type: "integer", nullable: false)
-                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
-                    AudibleCategoryId = table.Column<string>(type: "text", nullable: true),
-                    Name = table.Column<string>(type: "text", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Categories", x => x.CategoryId);
-                });
+		migrationBuilder.CreateTable(
+			name: "Categories",
+			columns: table => new
+			{
+				CategoryId = table.Column<int>(type: "integer", nullable: false)
+					.Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+				AudibleCategoryId = table.Column<string>(type: "text", nullable: true),
+				Name = table.Column<string>(type: "text", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Categories", x => x.CategoryId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "CategoryLadders",
-                columns: table => new
-                {
-                    CategoryLadderId = table.Column<int>(type: "integer", nullable: false)
-                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_CategoryLadders", x => x.CategoryLadderId);
-                });
+		migrationBuilder.CreateTable(
+			name: "CategoryLadders",
+			columns: table => new
+			{
+				CategoryLadderId = table.Column<int>(type: "integer", nullable: false)
+					.Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_CategoryLadders", x => x.CategoryLadderId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Contributors",
-                columns: table => new
-                {
-                    ContributorId = table.Column<int>(type: "integer", nullable: false)
-                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
-                    Name = table.Column<string>(type: "text", nullable: true),
-                    AudibleContributorId = table.Column<string>(type: "text", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Contributors", x => x.ContributorId);
-                });
+		migrationBuilder.CreateTable(
+			name: "Contributors",
+			columns: table => new
+			{
+				ContributorId = table.Column<int>(type: "integer", nullable: false)
+					.Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+				Name = table.Column<string>(type: "text", nullable: true),
+				AudibleContributorId = table.Column<string>(type: "text", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Contributors", x => x.ContributorId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Series",
-                columns: table => new
-                {
-                    SeriesId = table.Column<int>(type: "integer", nullable: false)
-                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
-                    AudibleSeriesId = table.Column<string>(type: "text", nullable: true),
-                    Name = table.Column<string>(type: "text", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Series", x => x.SeriesId);
-                });
+		migrationBuilder.CreateTable(
+			name: "Series",
+			columns: table => new
+			{
+				SeriesId = table.Column<int>(type: "integer", nullable: false)
+					.Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+				AudibleSeriesId = table.Column<string>(type: "text", nullable: true),
+				Name = table.Column<string>(type: "text", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Series", x => x.SeriesId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "LibraryBooks",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(type: "integer", nullable: false),
-                    DateAdded = table.Column<DateTime>(type: "timestamp without time zone", nullable: false),
-                    Account = table.Column<string>(type: "text", nullable: true),
-                    IsDeleted = table.Column<bool>(type: "boolean", nullable: false),
-                    AbsentFromLastScan = table.Column<bool>(type: "boolean", nullable: false),
-                    IncludedUntil = table.Column<DateTime>(type: "timestamp without time zone", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_LibraryBooks", x => x.BookId);
-                    table.ForeignKey(
-                        name: "FK_LibraryBooks_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "LibraryBooks",
+			columns: table => new
+			{
+				BookId = table.Column<int>(type: "integer", nullable: false),
+				DateAdded = table.Column<DateTime>(type: "timestamp without time zone", nullable: false),
+				Account = table.Column<string>(type: "text", nullable: true),
+				IsDeleted = table.Column<bool>(type: "boolean", nullable: false),
+				AbsentFromLastScan = table.Column<bool>(type: "boolean", nullable: false),
+				IncludedUntil = table.Column<DateTime>(type: "timestamp without time zone", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_LibraryBooks", x => x.BookId);
+				table.ForeignKey(
+					name: "FK_LibraryBooks_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Supplement",
-                columns: table => new
-                {
-                    SupplementId = table.Column<int>(type: "integer", nullable: false)
-                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
-                    BookId = table.Column<int>(type: "integer", nullable: false),
-                    Url = table.Column<string>(type: "text", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Supplement", x => x.SupplementId);
-                    table.ForeignKey(
-                        name: "FK_Supplement_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "Supplement",
+			columns: table => new
+			{
+				SupplementId = table.Column<int>(type: "integer", nullable: false)
+					.Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+				BookId = table.Column<int>(type: "integer", nullable: false),
+				Url = table.Column<string>(type: "text", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Supplement", x => x.SupplementId);
+				table.ForeignKey(
+					name: "FK_Supplement_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "UserDefinedItem",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(type: "integer", nullable: false),
-                    LastDownloaded = table.Column<DateTime>(type: "timestamp without time zone", nullable: true),
-                    LastDownloadedVersion = table.Column<string>(type: "text", nullable: true),
-                    LastDownloadedFormat = table.Column<long>(type: "bigint", nullable: true),
-                    LastDownloadedFileVersion = table.Column<string>(type: "text", nullable: true),
-                    Tags = table.Column<string>(type: "text", nullable: true),
-                    Rating_OverallRating = table.Column<float>(type: "real", nullable: true),
-                    Rating_PerformanceRating = table.Column<float>(type: "real", nullable: true),
-                    Rating_StoryRating = table.Column<float>(type: "real", nullable: true),
-                    BookStatus = table.Column<int>(type: "integer", nullable: false),
-                    PdfStatus = table.Column<int>(type: "integer", nullable: true),
-                    IsFinished = table.Column<bool>(type: "boolean", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_UserDefinedItem", x => x.BookId);
-                    table.ForeignKey(
-                        name: "FK_UserDefinedItem_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "UserDefinedItem",
+			columns: table => new
+			{
+				BookId = table.Column<int>(type: "integer", nullable: false),
+				LastDownloaded = table.Column<DateTime>(type: "timestamp without time zone", nullable: true),
+				LastDownloadedVersion = table.Column<string>(type: "text", nullable: true),
+				LastDownloadedFormat = table.Column<long>(type: "bigint", nullable: true),
+				LastDownloadedFileVersion = table.Column<string>(type: "text", nullable: true),
+				Tags = table.Column<string>(type: "text", nullable: true),
+				Rating_OverallRating = table.Column<float>(type: "real", nullable: true),
+				Rating_PerformanceRating = table.Column<float>(type: "real", nullable: true),
+				Rating_StoryRating = table.Column<float>(type: "real", nullable: true),
+				BookStatus = table.Column<int>(type: "integer", nullable: false),
+				PdfStatus = table.Column<int>(type: "integer", nullable: true),
+				IsFinished = table.Column<bool>(type: "boolean", nullable: false)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_UserDefinedItem", x => x.BookId);
+				table.ForeignKey(
+					name: "FK_UserDefinedItem_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "BookCategory",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(type: "integer", nullable: false),
-                    CategoryLadderId = table.Column<int>(type: "integer", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BookCategory", x => new { x.BookId, x.CategoryLadderId });
-                    table.ForeignKey(
-                        name: "FK_BookCategory_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_BookCategory_CategoryLadders_CategoryLadderId",
-                        column: x => x.CategoryLadderId,
-                        principalTable: "CategoryLadders",
-                        principalColumn: "CategoryLadderId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "BookCategory",
+			columns: table => new
+			{
+				BookId = table.Column<int>(type: "integer", nullable: false),
+				CategoryLadderId = table.Column<int>(type: "integer", nullable: false)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_BookCategory", x => new { x.BookId, x.CategoryLadderId });
+				table.ForeignKey(
+					name: "FK_BookCategory_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+				table.ForeignKey(
+					name: "FK_BookCategory_CategoryLadders_CategoryLadderId",
+					column: x => x.CategoryLadderId,
+					principalTable: "CategoryLadders",
+					principalColumn: "CategoryLadderId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "CategoryCategoryLadder",
-                columns: table => new
-                {
-                    _categoriesCategoryId = table.Column<int>(type: "integer", nullable: false),
-                    _categoryLaddersCategoryLadderId = table.Column<int>(type: "integer", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_CategoryCategoryLadder", x => new { x._categoriesCategoryId, x._categoryLaddersCategoryLadderId });
-                    table.ForeignKey(
-                        name: "FK_CategoryCategoryLadder_Categories__categoriesCategoryId",
-                        column: x => x._categoriesCategoryId,
-                        principalTable: "Categories",
-                        principalColumn: "CategoryId",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_CategoryCategoryLadder_CategoryLadders__categoryLaddersCate~",
-                        column: x => x._categoryLaddersCategoryLadderId,
-                        principalTable: "CategoryLadders",
-                        principalColumn: "CategoryLadderId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "CategoryCategoryLadder",
+			columns: table => new
+			{
+				_categoriesCategoryId = table.Column<int>(type: "integer", nullable: false),
+				_categoryLaddersCategoryLadderId = table.Column<int>(type: "integer", nullable: false)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_CategoryCategoryLadder", x => new { x._categoriesCategoryId, x._categoryLaddersCategoryLadderId });
+				table.ForeignKey(
+					name: "FK_CategoryCategoryLadder_Categories__categoriesCategoryId",
+					column: x => x._categoriesCategoryId,
+					principalTable: "Categories",
+					principalColumn: "CategoryId",
+					onDelete: ReferentialAction.Cascade);
+				table.ForeignKey(
+					name: "FK_CategoryCategoryLadder_CategoryLadders__categoryLaddersCate~",
+					column: x => x._categoryLaddersCategoryLadderId,
+					principalTable: "CategoryLadders",
+					principalColumn: "CategoryLadderId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "BookContributor",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(type: "integer", nullable: false),
-                    ContributorId = table.Column<int>(type: "integer", nullable: false),
-                    Role = table.Column<int>(type: "integer", nullable: false),
-                    Order = table.Column<byte>(type: "smallint", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BookContributor", x => new { x.BookId, x.ContributorId, x.Role });
-                    table.ForeignKey(
-                        name: "FK_BookContributor_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_BookContributor_Contributors_ContributorId",
-                        column: x => x.ContributorId,
-                        principalTable: "Contributors",
-                        principalColumn: "ContributorId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "BookContributor",
+			columns: table => new
+			{
+				BookId = table.Column<int>(type: "integer", nullable: false),
+				ContributorId = table.Column<int>(type: "integer", nullable: false),
+				Role = table.Column<int>(type: "integer", nullable: false),
+				Order = table.Column<byte>(type: "smallint", nullable: false)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_BookContributor", x => new { x.BookId, x.ContributorId, x.Role });
+				table.ForeignKey(
+					name: "FK_BookContributor_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+				table.ForeignKey(
+					name: "FK_BookContributor_Contributors_ContributorId",
+					column: x => x.ContributorId,
+					principalTable: "Contributors",
+					principalColumn: "ContributorId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "SeriesBook",
-                columns: table => new
-                {
-                    SeriesId = table.Column<int>(type: "integer", nullable: false),
-                    BookId = table.Column<int>(type: "integer", nullable: false),
-                    Order = table.Column<string>(type: "text", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_SeriesBook", x => new { x.SeriesId, x.BookId });
-                    table.ForeignKey(
-                        name: "FK_SeriesBook_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_SeriesBook_Series_SeriesId",
-                        column: x => x.SeriesId,
-                        principalTable: "Series",
-                        principalColumn: "SeriesId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "SeriesBook",
+			columns: table => new
+			{
+				SeriesId = table.Column<int>(type: "integer", nullable: false),
+				BookId = table.Column<int>(type: "integer", nullable: false),
+				Order = table.Column<string>(type: "text", nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_SeriesBook", x => new { x.SeriesId, x.BookId });
+				table.ForeignKey(
+					name: "FK_SeriesBook_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+				table.ForeignKey(
+					name: "FK_SeriesBook_Series_SeriesId",
+					column: x => x.SeriesId,
+					principalTable: "Series",
+					principalColumn: "SeriesId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.InsertData(
-                table: "Contributors",
-                columns: new[] { "ContributorId", "AudibleContributorId", "Name" },
-                values: new object[] { -1, null, "" });
+		migrationBuilder.InsertData(
+			table: "Contributors",
+			columns: new[] { "ContributorId", "AudibleContributorId", "Name" },
+			values: new object[] { -1, null, "" });
 
-            migrationBuilder.CreateIndex(
-                name: "IX_BookCategory_BookId",
-                table: "BookCategory",
-                column: "BookId");
+		migrationBuilder.CreateIndex(
+			name: "IX_BookCategory_BookId",
+			table: "BookCategory",
+			column: "BookId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_BookCategory_CategoryLadderId",
-                table: "BookCategory",
-                column: "CategoryLadderId");
+		migrationBuilder.CreateIndex(
+			name: "IX_BookCategory_CategoryLadderId",
+			table: "BookCategory",
+			column: "CategoryLadderId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_BookContributor_BookId",
-                table: "BookContributor",
-                column: "BookId");
+		migrationBuilder.CreateIndex(
+			name: "IX_BookContributor_BookId",
+			table: "BookContributor",
+			column: "BookId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_BookContributor_ContributorId",
-                table: "BookContributor",
-                column: "ContributorId");
+		migrationBuilder.CreateIndex(
+			name: "IX_BookContributor_ContributorId",
+			table: "BookContributor",
+			column: "ContributorId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Books_AudibleProductId",
-                table: "Books",
-                column: "AudibleProductId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Books_AudibleProductId",
+			table: "Books",
+			column: "AudibleProductId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Categories_AudibleCategoryId",
-                table: "Categories",
-                column: "AudibleCategoryId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Categories_AudibleCategoryId",
+			table: "Categories",
+			column: "AudibleCategoryId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_CategoryCategoryLadder__categoryLaddersCategoryLadderId",
-                table: "CategoryCategoryLadder",
-                column: "_categoryLaddersCategoryLadderId");
+		migrationBuilder.CreateIndex(
+			name: "IX_CategoryCategoryLadder__categoryLaddersCategoryLadderId",
+			table: "CategoryCategoryLadder",
+			column: "_categoryLaddersCategoryLadderId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Contributors_Name",
-                table: "Contributors",
-                column: "Name");
+		migrationBuilder.CreateIndex(
+			name: "IX_Contributors_Name",
+			table: "Contributors",
+			column: "Name");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Series_AudibleSeriesId",
-                table: "Series",
-                column: "AudibleSeriesId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Series_AudibleSeriesId",
+			table: "Series",
+			column: "AudibleSeriesId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_SeriesBook_BookId",
-                table: "SeriesBook",
-                column: "BookId");
+		migrationBuilder.CreateIndex(
+			name: "IX_SeriesBook_BookId",
+			table: "SeriesBook",
+			column: "BookId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_SeriesBook_SeriesId",
-                table: "SeriesBook",
-                column: "SeriesId");
+		migrationBuilder.CreateIndex(
+			name: "IX_SeriesBook_SeriesId",
+			table: "SeriesBook",
+			column: "SeriesId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Supplement_BookId",
-                table: "Supplement",
-                column: "BookId");
-        }
+		migrationBuilder.CreateIndex(
+			name: "IX_Supplement_BookId",
+			table: "Supplement",
+			column: "BookId");
+	}
 
-        /// <inheritdoc />
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable(
-                name: "BookCategory");
+	/// <inheritdoc />
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropTable(
+			name: "BookCategory");
 
-            migrationBuilder.DropTable(
-                name: "BookContributor");
+		migrationBuilder.DropTable(
+			name: "BookContributor");
 
-            migrationBuilder.DropTable(
-                name: "CategoryCategoryLadder");
+		migrationBuilder.DropTable(
+			name: "CategoryCategoryLadder");
 
-            migrationBuilder.DropTable(
-                name: "LibraryBooks");
+		migrationBuilder.DropTable(
+			name: "LibraryBooks");
 
-            migrationBuilder.DropTable(
-                name: "SeriesBook");
+		migrationBuilder.DropTable(
+			name: "SeriesBook");
 
-            migrationBuilder.DropTable(
-                name: "Supplement");
+		migrationBuilder.DropTable(
+			name: "Supplement");
 
-            migrationBuilder.DropTable(
-                name: "UserDefinedItem");
+		migrationBuilder.DropTable(
+			name: "UserDefinedItem");
 
-            migrationBuilder.DropTable(
-                name: "Contributors");
+		migrationBuilder.DropTable(
+			name: "Contributors");
 
-            migrationBuilder.DropTable(
-                name: "Categories");
+		migrationBuilder.DropTable(
+			name: "Categories");
 
-            migrationBuilder.DropTable(
-                name: "CategoryLadders");
+		migrationBuilder.DropTable(
+			name: "CategoryLadders");
 
-            migrationBuilder.DropTable(
-                name: "Series");
+		migrationBuilder.DropTable(
+			name: "Series");
 
-            migrationBuilder.DropTable(
-                name: "Books");
-        }
-    }
+		migrationBuilder.DropTable(
+			name: "Books");
+	}
 }

Source/DataLayer.Postgres/Migrations/20260107224301_AddIsAudiblePlus.Designer.cs

@@ -0,0 +1,499 @@
+// <auto-generated />
+using System;
+using DataLayer;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace DataLayer.Postgres.Migrations
+{
+    [DbContext(typeof(LibationContext))]
+    [Migration("20260107224301_AddIsAudiblePlus")]
+    partial class AddIsAudiblePlus
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.0")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("CategoryCategoryLadder", b =>
+                {
+                    b.Property<int>("_categoriesCategoryId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("_categoryLaddersCategoryLadderId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("_categoriesCategoryId", "_categoryLaddersCategoryLadderId");
+
+                    b.HasIndex("_categoryLaddersCategoryLadderId");
+
+                    b.ToTable("CategoryCategoryLadder");
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.Property<int>("BookId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("BookId"));
+
+                    b.Property<string>("AudibleProductId")
+                        .HasColumnType("text");
+
+                    b.Property<int>("ContentType")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime?>("DatePublished")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<string>("Description")
+                        .HasColumnType("text");
+
+                    b.Property<bool>("IsAbridged")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsSpatial")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Language")
+                        .HasColumnType("text");
+
+                    b.Property<int>("LengthInMinutes")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Locale")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PictureId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PictureLarge")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Subtitle")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("text");
+
+                    b.HasKey("BookId");
+
+                    b.HasIndex("AudibleProductId");
+
+                    b.ToTable("Books");
+                });
+
+            modelBuilder.Entity("DataLayer.BookCategory", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("CategoryLadderId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("BookId", "CategoryLadderId");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("CategoryLadderId");
+
+                    b.ToTable("BookCategory");
+                });
+
+            modelBuilder.Entity("DataLayer.BookContributor", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("ContributorId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("Role")
+                        .HasColumnType("integer");
+
+                    b.Property<byte>("Order")
+                        .HasColumnType("smallint");
+
+                    b.HasKey("BookId", "ContributorId", "Role");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("ContributorId");
+
+                    b.ToTable("BookContributor");
+                });
+
+            modelBuilder.Entity("DataLayer.Category", b =>
+                {
+                    b.Property<int>("CategoryId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryId"));
+
+                    b.Property<string>("AudibleCategoryId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.HasKey("CategoryId");
+
+                    b.HasIndex("AudibleCategoryId");
+
+                    b.ToTable("Categories");
+                });
+
+            modelBuilder.Entity("DataLayer.CategoryLadder", b =>
+                {
+                    b.Property<int>("CategoryLadderId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryLadderId"));
+
+                    b.HasKey("CategoryLadderId");
+
+                    b.ToTable("CategoryLadders");
+                });
+
+            modelBuilder.Entity("DataLayer.Contributor", b =>
+                {
+                    b.Property<int>("ContributorId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("ContributorId"));
+
+                    b.Property<string>("AudibleContributorId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.HasKey("ContributorId");
+
+                    b.HasIndex("Name");
+
+                    b.ToTable("Contributors");
+
+                    b.HasData(
+                        new
+                        {
+                            ContributorId = -1,
+                            Name = ""
+                        });
+                });
+
+            modelBuilder.Entity("DataLayer.LibraryBook", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<bool>("AbsentFromLastScan")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Account")
+                        .HasColumnType("text");
+
+                    b.Property<DateTime>("DateAdded")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<DateTime?>("IncludedUntil")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<bool>("IsAudiblePlus")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsDeleted")
+                        .HasColumnType("boolean");
+
+                    b.HasKey("BookId");
+
+                    b.ToTable("LibraryBooks");
+                });
+
+            modelBuilder.Entity("DataLayer.Series", b =>
+                {
+                    b.Property<int>("SeriesId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("SeriesId"));
+
+                    b.Property<string>("AudibleSeriesId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.HasKey("SeriesId");
+
+                    b.HasIndex("AudibleSeriesId");
+
+                    b.ToTable("Series");
+                });
+
+            modelBuilder.Entity("DataLayer.SeriesBook", b =>
+                {
+                    b.Property<int>("SeriesId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Order")
+                        .HasColumnType("text");
+
+                    b.HasKey("SeriesId", "BookId");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("SeriesId");
+
+                    b.ToTable("SeriesBook");
+                });
+
+            modelBuilder.Entity("CategoryCategoryLadder", b =>
+                {
+                    b.HasOne("DataLayer.Category", null)
+                        .WithMany()
+                        .HasForeignKey("_categoriesCategoryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.CategoryLadder", null)
+                        .WithMany()
+                        .HasForeignKey("_categoryLaddersCategoryLadderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.OwnsOne("DataLayer.Rating", "Rating", b1 =>
+                        {
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<float>("OverallRating")
+                                .HasColumnType("real");
+
+                            b1.Property<float>("PerformanceRating")
+                                .HasColumnType("real");
+
+                            b1.Property<float>("StoryRating")
+                                .HasColumnType("real");
+
+                            b1.HasKey("BookId");
+
+                            b1.ToTable("Books");
+
+                            b1.WithOwner()
+                                .HasForeignKey("BookId");
+                        });
+
+                    b.OwnsMany("DataLayer.Supplement", "Supplements", b1 =>
+                        {
+                            b1.Property<int>("SupplementId")
+                                .ValueGeneratedOnAdd()
+                                .HasColumnType("integer");
+
+                            NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b1.Property<int>("SupplementId"));
+
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Url")
+                                .HasColumnType("text");
+
+                            b1.HasKey("SupplementId");
+
+                            b1.HasIndex("BookId");
+
+                            b1.ToTable("Supplement");
+
+                            b1.WithOwner("Book")
+                                .HasForeignKey("BookId");
+
+                            b1.Navigation("Book");
+                        });
+
+                    b.OwnsOne("DataLayer.UserDefinedItem", "UserDefinedItem", b1 =>
+                        {
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<int>("BookStatus")
+                                .HasColumnType("integer");
+
+                            b1.Property<bool>("IsFinished")
+                                .HasColumnType("boolean");
+
+                            b1.Property<DateTime?>("LastDownloaded")
+                                .HasColumnType("timestamp without time zone");
+
+                            b1.Property<string>("LastDownloadedFileVersion")
+                                .HasColumnType("text");
+
+                            b1.Property<long?>("LastDownloadedFormat")
+                                .HasColumnType("bigint");
+
+                            b1.Property<string>("LastDownloadedVersion")
+                                .HasColumnType("text");
+
+                            b1.Property<int?>("PdfStatus")
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Tags")
+                                .IsRequired()
+                                .HasColumnType("text");
+
+                            b1.HasKey("BookId");
+
+                            b1.ToTable("UserDefinedItem", (string)null);
+
+                            b1.WithOwner("Book")
+                                .HasForeignKey("BookId");
+
+                            b1.OwnsOne("DataLayer.Rating", "Rating", b2 =>
+                                {
+                                    b2.Property<int>("UserDefinedItemBookId")
+                                        .HasColumnType("integer");
+
+                                    b2.Property<float>("OverallRating")
+                                        .HasColumnType("real");
+
+                                    b2.Property<float>("PerformanceRating")
+                                        .HasColumnType("real");
+
+                                    b2.Property<float>("StoryRating")
+                                        .HasColumnType("real");
+
+                                    b2.HasKey("UserDefinedItemBookId");
+
+                                    b2.ToTable("UserDefinedItem");
+
+                                    b2.WithOwner()
+                                        .HasForeignKey("UserDefinedItemBookId");
+                                });
+
+                            b1.Navigation("Book");
+
+                            b1.Navigation("Rating")
+                                .IsRequired();
+                        });
+
+                    b.Navigation("Rating");
+
+                    b.Navigation("Supplements");
+
+                    b.Navigation("UserDefinedItem");
+                });
+
+            modelBuilder.Entity("DataLayer.BookCategory", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("CategoriesLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.CategoryLadder", "CategoryLadder")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("CategoryLadderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("CategoryLadder");
+                });
+
+            modelBuilder.Entity("DataLayer.BookContributor", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("ContributorsLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.Contributor", "Contributor")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("ContributorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("Contributor");
+                });
+
+            modelBuilder.Entity("DataLayer.LibraryBook", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithOne()
+                        .HasForeignKey("DataLayer.LibraryBook", "BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+                });
+
+            modelBuilder.Entity("DataLayer.SeriesBook", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("SeriesLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.Series", "Series")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("SeriesId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("Series");
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.Navigation("CategoriesLink");
+
+                    b.Navigation("ContributorsLink");
+
+                    b.Navigation("SeriesLink");
+                });
+
+            modelBuilder.Entity("DataLayer.CategoryLadder", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+
+            modelBuilder.Entity("DataLayer.Contributor", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+
+            modelBuilder.Entity("DataLayer.Series", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

Source/DataLayer.Postgres/Migrations/20260107224301_AddIsAudiblePlus.cs

@@ -0,0 +1,98 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace DataLayer.Postgres.Migrations;
+
+/// <inheritdoc />
+public partial class AddIsAudiblePlus : Migration
+{
+	/// <inheritdoc />
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.AlterColumn<string>(
+			name: "Tags",
+			table: "UserDefinedItem",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_StoryRating",
+			table: "UserDefinedItem",
+			type: "real",
+			nullable: false,
+			defaultValue: 0f,
+			oldClrType: typeof(float),
+			oldType: "real",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_PerformanceRating",
+			table: "UserDefinedItem",
+			type: "real",
+			nullable: false,
+			defaultValue: 0f,
+			oldClrType: typeof(float),
+			oldType: "real",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_OverallRating",
+			table: "UserDefinedItem",
+			type: "real",
+			nullable: false,
+			defaultValue: 0f,
+			oldClrType: typeof(float),
+			oldType: "real",
+			oldNullable: true);
+
+		migrationBuilder.AddColumn<bool>(
+			name: "IsAudiblePlus",
+			table: "LibraryBooks",
+			type: "boolean",
+			nullable: false,
+			defaultValue: false);
+	}
+
+	/// <inheritdoc />
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropColumn(
+			name: "IsAudiblePlus",
+			table: "LibraryBooks");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Tags",
+			table: "UserDefinedItem",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_StoryRating",
+			table: "UserDefinedItem",
+			type: "real",
+			nullable: true,
+			oldClrType: typeof(float),
+			oldType: "real");
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_PerformanceRating",
+			table: "UserDefinedItem",
+			type: "real",
+			nullable: true,
+			oldClrType: typeof(float),
+			oldType: "real");
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_OverallRating",
+			table: "UserDefinedItem",
+			type: "real",
+			nullable: true,
+			oldClrType: typeof(float),
+			oldType: "real");
+	}
+}

Source/DataLayer.Postgres/Migrations/20260205171041_MakeDbNullable.Designer.cs

@@ -0,0 +1,508 @@
+// <auto-generated />
+using System;
+using DataLayer;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace DataLayer.Postgres.Migrations
+{
+    [DbContext(typeof(LibationContext))]
+    [Migration("20260205171041_MakeDbNullable")]
+    partial class MakeDbNullable
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.2")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("CategoryCategoryLadder", b =>
+                {
+                    b.Property<int>("_categoriesCategoryId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("_categoryLaddersCategoryLadderId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("_categoriesCategoryId", "_categoryLaddersCategoryLadderId");
+
+                    b.HasIndex("_categoryLaddersCategoryLadderId");
+
+                    b.ToTable("CategoryCategoryLadder");
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.Property<int>("BookId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("BookId"));
+
+                    b.Property<string>("AudibleProductId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<int>("ContentType")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime?>("DatePublished")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<string>("Description")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<bool>("IsAbridged")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsSpatial")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Language")
+                        .HasColumnType("text");
+
+                    b.Property<int>("LengthInMinutes")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Locale")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("PictureId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PictureLarge")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Subtitle")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("BookId");
+
+                    b.HasIndex("AudibleProductId");
+
+                    b.ToTable("Books");
+                });
+
+            modelBuilder.Entity("DataLayer.BookCategory", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("CategoryLadderId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("BookId", "CategoryLadderId");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("CategoryLadderId");
+
+                    b.ToTable("BookCategory");
+                });
+
+            modelBuilder.Entity("DataLayer.BookContributor", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("ContributorId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("Role")
+                        .HasColumnType("integer");
+
+                    b.Property<byte>("Order")
+                        .HasColumnType("smallint");
+
+                    b.HasKey("BookId", "ContributorId", "Role");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("ContributorId");
+
+                    b.ToTable("BookContributor");
+                });
+
+            modelBuilder.Entity("DataLayer.Category", b =>
+                {
+                    b.Property<int>("CategoryId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryId"));
+
+                    b.Property<string>("AudibleCategoryId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("CategoryId");
+
+                    b.HasIndex("AudibleCategoryId");
+
+                    b.ToTable("Categories");
+                });
+
+            modelBuilder.Entity("DataLayer.CategoryLadder", b =>
+                {
+                    b.Property<int>("CategoryLadderId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryLadderId"));
+
+                    b.HasKey("CategoryLadderId");
+
+                    b.ToTable("CategoryLadders");
+                });
+
+            modelBuilder.Entity("DataLayer.Contributor", b =>
+                {
+                    b.Property<int>("ContributorId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("ContributorId"));
+
+                    b.Property<string>("AudibleContributorId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("ContributorId");
+
+                    b.HasIndex("Name");
+
+                    b.ToTable("Contributors");
+
+                    b.HasData(
+                        new
+                        {
+                            ContributorId = -1,
+                            Name = ""
+                        });
+                });
+
+            modelBuilder.Entity("DataLayer.LibraryBook", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<bool>("AbsentFromLastScan")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Account")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<DateTime>("DateAdded")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<DateTime?>("IncludedUntil")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<bool>("IsAudiblePlus")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsDeleted")
+                        .HasColumnType("boolean");
+
+                    b.HasKey("BookId");
+
+                    b.ToTable("LibraryBooks");
+                });
+
+            modelBuilder.Entity("DataLayer.Series", b =>
+                {
+                    b.Property<int>("SeriesId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("SeriesId"));
+
+                    b.Property<string>("AudibleSeriesId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.HasKey("SeriesId");
+
+                    b.HasIndex("AudibleSeriesId");
+
+                    b.ToTable("Series");
+                });
+
+            modelBuilder.Entity("DataLayer.SeriesBook", b =>
+                {
+                    b.Property<int>("SeriesId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Order")
+                        .HasColumnType("text");
+
+                    b.HasKey("SeriesId", "BookId");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("SeriesId");
+
+                    b.ToTable("SeriesBook");
+                });
+
+            modelBuilder.Entity("CategoryCategoryLadder", b =>
+                {
+                    b.HasOne("DataLayer.Category", null)
+                        .WithMany()
+                        .HasForeignKey("_categoriesCategoryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.CategoryLadder", null)
+                        .WithMany()
+                        .HasForeignKey("_categoryLaddersCategoryLadderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.OwnsOne("DataLayer.Rating", "Rating", b1 =>
+                        {
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<float>("OverallRating")
+                                .HasColumnType("real");
+
+                            b1.Property<float>("PerformanceRating")
+                                .HasColumnType("real");
+
+                            b1.Property<float>("StoryRating")
+                                .HasColumnType("real");
+
+                            b1.HasKey("BookId");
+
+                            b1.ToTable("Books");
+
+                            b1.WithOwner()
+                                .HasForeignKey("BookId");
+                        });
+
+                    b.OwnsMany("DataLayer.Supplement", "Supplements", b1 =>
+                        {
+                            b1.Property<int>("SupplementId")
+                                .ValueGeneratedOnAdd()
+                                .HasColumnType("integer");
+
+                            NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b1.Property<int>("SupplementId"));
+
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Url")
+                                .IsRequired()
+                                .HasColumnType("text");
+
+                            b1.HasKey("SupplementId");
+
+                            b1.HasIndex("BookId");
+
+                            b1.ToTable("Supplement");
+
+                            b1.WithOwner("Book")
+                                .HasForeignKey("BookId");
+
+                            b1.Navigation("Book");
+                        });
+
+                    b.OwnsOne("DataLayer.UserDefinedItem", "UserDefinedItem", b1 =>
+                        {
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<int>("BookStatus")
+                                .HasColumnType("integer");
+
+                            b1.Property<bool>("IsFinished")
+                                .HasColumnType("boolean");
+
+                            b1.Property<DateTime?>("LastDownloaded")
+                                .HasColumnType("timestamp without time zone");
+
+                            b1.Property<string>("LastDownloadedFileVersion")
+                                .HasColumnType("text");
+
+                            b1.Property<long?>("LastDownloadedFormat")
+                                .HasColumnType("bigint");
+
+                            b1.Property<string>("LastDownloadedVersion")
+                                .HasColumnType("text");
+
+                            b1.Property<int?>("PdfStatus")
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Tags")
+                                .IsRequired()
+                                .HasColumnType("text");
+
+                            b1.HasKey("BookId");
+
+                            b1.ToTable("UserDefinedItem", (string)null);
+
+                            b1.WithOwner("Book")
+                                .HasForeignKey("BookId");
+
+                            b1.OwnsOne("DataLayer.Rating", "Rating", b2 =>
+                                {
+                                    b2.Property<int>("UserDefinedItemBookId")
+                                        .HasColumnType("integer");
+
+                                    b2.Property<float>("OverallRating")
+                                        .HasColumnType("real");
+
+                                    b2.Property<float>("PerformanceRating")
+                                        .HasColumnType("real");
+
+                                    b2.Property<float>("StoryRating")
+                                        .HasColumnType("real");
+
+                                    b2.HasKey("UserDefinedItemBookId");
+
+                                    b2.ToTable("UserDefinedItem");
+
+                                    b2.WithOwner()
+                                        .HasForeignKey("UserDefinedItemBookId");
+                                });
+
+                            b1.Navigation("Book");
+
+                            b1.Navigation("Rating")
+                                .IsRequired();
+                        });
+
+                    b.Navigation("Rating")
+                        .IsRequired();
+
+                    b.Navigation("Supplements");
+
+                    b.Navigation("UserDefinedItem")
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("DataLayer.BookCategory", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("CategoriesLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.CategoryLadder", "CategoryLadder")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("CategoryLadderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("CategoryLadder");
+                });
+
+            modelBuilder.Entity("DataLayer.BookContributor", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("ContributorsLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.Contributor", "Contributor")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("ContributorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("Contributor");
+                });
+
+            modelBuilder.Entity("DataLayer.LibraryBook", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithOne()
+                        .HasForeignKey("DataLayer.LibraryBook", "BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+                });
+
+            modelBuilder.Entity("DataLayer.SeriesBook", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("SeriesLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.Series", "Series")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("SeriesId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("Series");
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.Navigation("CategoriesLink");
+
+                    b.Navigation("ContributorsLink");
+
+                    b.Navigation("SeriesLink");
+                });
+
+            modelBuilder.Entity("DataLayer.CategoryLadder", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+
+            modelBuilder.Entity("DataLayer.Contributor", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+
+            modelBuilder.Entity("DataLayer.Series", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

Source/DataLayer.Postgres/Migrations/20260205171041_MakeDbNullable.cs

@@ -0,0 +1,259 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace DataLayer.Postgres.Migrations;
+
+/// <inheritdoc />
+public partial class MakeDbNullable : Migration
+{
+	/// <inheritdoc />
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropColumn(
+			name: "Name",
+			table: "Categories");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Url",
+			table: "Supplement",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "AudibleSeriesId",
+			table: "Series",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Account",
+			table: "LibraryBooks",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Name",
+			table: "Contributors",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "AudibleCategoryId",
+			table: "Categories",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Title",
+			table: "Books",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Subtitle",
+			table: "Books",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_StoryRating",
+			table: "Books",
+			type: "real",
+			nullable: false,
+			defaultValue: 0f,
+			oldClrType: typeof(float),
+			oldType: "real",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_PerformanceRating",
+			table: "Books",
+			type: "real",
+			nullable: false,
+			defaultValue: 0f,
+			oldClrType: typeof(float),
+			oldType: "real",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_OverallRating",
+			table: "Books",
+			type: "real",
+			nullable: false,
+			defaultValue: 0f,
+			oldClrType: typeof(float),
+			oldType: "real",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Locale",
+			table: "Books",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Description",
+			table: "Books",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "AudibleProductId",
+			table: "Books",
+			type: "text",
+			nullable: false,
+			defaultValue: "",
+			oldClrType: typeof(string),
+			oldType: "text",
+			oldNullable: true);
+	}
+
+	/// <inheritdoc />
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.AlterColumn<string>(
+			name: "Url",
+			table: "Supplement",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "AudibleSeriesId",
+			table: "Series",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Account",
+			table: "LibraryBooks",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Name",
+			table: "Contributors",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "AudibleCategoryId",
+			table: "Categories",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AddColumn<string>(
+			name: "Name",
+			table: "Categories",
+			type: "text",
+			nullable: true);
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Title",
+			table: "Books",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Subtitle",
+			table: "Books",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_StoryRating",
+			table: "Books",
+			type: "real",
+			nullable: true,
+			oldClrType: typeof(float),
+			oldType: "real");
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_PerformanceRating",
+			table: "Books",
+			type: "real",
+			nullable: true,
+			oldClrType: typeof(float),
+			oldType: "real");
+
+		migrationBuilder.AlterColumn<float>(
+			name: "Rating_OverallRating",
+			table: "Books",
+			type: "real",
+			nullable: true,
+			oldClrType: typeof(float),
+			oldType: "real");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Locale",
+			table: "Books",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "Description",
+			table: "Books",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+
+		migrationBuilder.AlterColumn<string>(
+			name: "AudibleProductId",
+			table: "Books",
+			type: "text",
+			nullable: true,
+			oldClrType: typeof(string),
+			oldType: "text");
+	}
+}

Source/DataLayer.Postgres/Migrations/20260427201825_ReAddCategoryName2.Designer.cs

@@ -0,0 +1,512 @@
+// <auto-generated />
+using System;
+using DataLayer;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace DataLayer.Postgres.Migrations
+{
+    [DbContext(typeof(LibationContext))]
+    [Migration("20260427201825_ReAddCategoryName2")]
+    partial class ReAddCategoryName2
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.2")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("CategoryCategoryLadder", b =>
+                {
+                    b.Property<int>("_categoriesCategoryId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("_categoryLaddersCategoryLadderId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("_categoriesCategoryId", "_categoryLaddersCategoryLadderId");
+
+                    b.HasIndex("_categoryLaddersCategoryLadderId");
+
+                    b.ToTable("CategoryCategoryLadder");
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.Property<int>("BookId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("BookId"));
+
+                    b.Property<string>("AudibleProductId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<int>("ContentType")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime?>("DatePublished")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<string>("Description")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<bool>("IsAbridged")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsSpatial")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Language")
+                        .HasColumnType("text");
+
+                    b.Property<int>("LengthInMinutes")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Locale")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("PictureId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PictureLarge")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Subtitle")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("BookId");
+
+                    b.HasIndex("AudibleProductId");
+
+                    b.ToTable("Books");
+                });
+
+            modelBuilder.Entity("DataLayer.BookCategory", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("CategoryLadderId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("BookId", "CategoryLadderId");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("CategoryLadderId");
+
+                    b.ToTable("BookCategory");
+                });
+
+            modelBuilder.Entity("DataLayer.BookContributor", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("ContributorId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("Role")
+                        .HasColumnType("integer");
+
+                    b.Property<byte>("Order")
+                        .HasColumnType("smallint");
+
+                    b.HasKey("BookId", "ContributorId", "Role");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("ContributorId");
+
+                    b.ToTable("BookContributor");
+                });
+
+            modelBuilder.Entity("DataLayer.Category", b =>
+                {
+                    b.Property<int>("CategoryId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryId"));
+
+                    b.Property<string>("AudibleCategoryId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("CategoryId");
+
+                    b.HasIndex("AudibleCategoryId");
+
+                    b.ToTable("Categories");
+                });
+
+            modelBuilder.Entity("DataLayer.CategoryLadder", b =>
+                {
+                    b.Property<int>("CategoryLadderId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryLadderId"));
+
+                    b.HasKey("CategoryLadderId");
+
+                    b.ToTable("CategoryLadders");
+                });
+
+            modelBuilder.Entity("DataLayer.Contributor", b =>
+                {
+                    b.Property<int>("ContributorId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("ContributorId"));
+
+                    b.Property<string>("AudibleContributorId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("ContributorId");
+
+                    b.HasIndex("Name");
+
+                    b.ToTable("Contributors");
+
+                    b.HasData(
+                        new
+                        {
+                            ContributorId = -1,
+                            Name = ""
+                        });
+                });
+
+            modelBuilder.Entity("DataLayer.LibraryBook", b =>
+                {
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<bool>("AbsentFromLastScan")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Account")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<DateTime>("DateAdded")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<DateTime?>("IncludedUntil")
+                        .HasColumnType("timestamp without time zone");
+
+                    b.Property<bool>("IsAudiblePlus")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsDeleted")
+                        .HasColumnType("boolean");
+
+                    b.HasKey("BookId");
+
+                    b.ToTable("LibraryBooks");
+                });
+
+            modelBuilder.Entity("DataLayer.Series", b =>
+                {
+                    b.Property<int>("SeriesId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("SeriesId"));
+
+                    b.Property<string>("AudibleSeriesId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.HasKey("SeriesId");
+
+                    b.HasIndex("AudibleSeriesId");
+
+                    b.ToTable("Series");
+                });
+
+            modelBuilder.Entity("DataLayer.SeriesBook", b =>
+                {
+                    b.Property<int>("SeriesId")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("BookId")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Order")
+                        .HasColumnType("text");
+
+                    b.HasKey("SeriesId", "BookId");
+
+                    b.HasIndex("BookId");
+
+                    b.HasIndex("SeriesId");
+
+                    b.ToTable("SeriesBook");
+                });
+
+            modelBuilder.Entity("CategoryCategoryLadder", b =>
+                {
+                    b.HasOne("DataLayer.Category", null)
+                        .WithMany()
+                        .HasForeignKey("_categoriesCategoryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.CategoryLadder", null)
+                        .WithMany()
+                        .HasForeignKey("_categoryLaddersCategoryLadderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.OwnsOne("DataLayer.Rating", "Rating", b1 =>
+                        {
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<float>("OverallRating")
+                                .HasColumnType("real");
+
+                            b1.Property<float>("PerformanceRating")
+                                .HasColumnType("real");
+
+                            b1.Property<float>("StoryRating")
+                                .HasColumnType("real");
+
+                            b1.HasKey("BookId");
+
+                            b1.ToTable("Books");
+
+                            b1.WithOwner()
+                                .HasForeignKey("BookId");
+                        });
+
+                    b.OwnsMany("DataLayer.Supplement", "Supplements", b1 =>
+                        {
+                            b1.Property<int>("SupplementId")
+                                .ValueGeneratedOnAdd()
+                                .HasColumnType("integer");
+
+                            NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b1.Property<int>("SupplementId"));
+
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Url")
+                                .IsRequired()
+                                .HasColumnType("text");
+
+                            b1.HasKey("SupplementId");
+
+                            b1.HasIndex("BookId");
+
+                            b1.ToTable("Supplement");
+
+                            b1.WithOwner("Book")
+                                .HasForeignKey("BookId");
+
+                            b1.Navigation("Book");
+                        });
+
+                    b.OwnsOne("DataLayer.UserDefinedItem", "UserDefinedItem", b1 =>
+                        {
+                            b1.Property<int>("BookId")
+                                .HasColumnType("integer");
+
+                            b1.Property<int>("BookStatus")
+                                .HasColumnType("integer");
+
+                            b1.Property<bool>("IsFinished")
+                                .HasColumnType("boolean");
+
+                            b1.Property<DateTime?>("LastDownloaded")
+                                .HasColumnType("timestamp without time zone");
+
+                            b1.Property<string>("LastDownloadedFileVersion")
+                                .HasColumnType("text");
+
+                            b1.Property<long?>("LastDownloadedFormat")
+                                .HasColumnType("bigint");
+
+                            b1.Property<string>("LastDownloadedVersion")
+                                .HasColumnType("text");
+
+                            b1.Property<int?>("PdfStatus")
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Tags")
+                                .IsRequired()
+                                .HasColumnType("text");
+
+                            b1.HasKey("BookId");
+
+                            b1.ToTable("UserDefinedItem", (string)null);
+
+                            b1.WithOwner("Book")
+                                .HasForeignKey("BookId");
+
+                            b1.OwnsOne("DataLayer.Rating", "Rating", b2 =>
+                                {
+                                    b2.Property<int>("UserDefinedItemBookId")
+                                        .HasColumnType("integer");
+
+                                    b2.Property<float>("OverallRating")
+                                        .HasColumnType("real");
+
+                                    b2.Property<float>("PerformanceRating")
+                                        .HasColumnType("real");
+
+                                    b2.Property<float>("StoryRating")
+                                        .HasColumnType("real");
+
+                                    b2.HasKey("UserDefinedItemBookId");
+
+                                    b2.ToTable("UserDefinedItem");
+
+                                    b2.WithOwner()
+                                        .HasForeignKey("UserDefinedItemBookId");
+                                });
+
+                            b1.Navigation("Book");
+
+                            b1.Navigation("Rating")
+                                .IsRequired();
+                        });
+
+                    b.Navigation("Rating")
+                        .IsRequired();
+
+                    b.Navigation("Supplements");
+
+                    b.Navigation("UserDefinedItem")
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("DataLayer.BookCategory", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("CategoriesLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.CategoryLadder", "CategoryLadder")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("CategoryLadderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("CategoryLadder");
+                });
+
+            modelBuilder.Entity("DataLayer.BookContributor", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("ContributorsLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.Contributor", "Contributor")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("ContributorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("Contributor");
+                });
+
+            modelBuilder.Entity("DataLayer.LibraryBook", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithOne()
+                        .HasForeignKey("DataLayer.LibraryBook", "BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+                });
+
+            modelBuilder.Entity("DataLayer.SeriesBook", b =>
+                {
+                    b.HasOne("DataLayer.Book", "Book")
+                        .WithMany("SeriesLink")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("DataLayer.Series", "Series")
+                        .WithMany("BooksLink")
+                        .HasForeignKey("SeriesId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+
+                    b.Navigation("Series");
+                });
+
+            modelBuilder.Entity("DataLayer.Book", b =>
+                {
+                    b.Navigation("CategoriesLink");
+
+                    b.Navigation("ContributorsLink");
+
+                    b.Navigation("SeriesLink");
+                });
+
+            modelBuilder.Entity("DataLayer.CategoryLadder", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+
+            modelBuilder.Entity("DataLayer.Contributor", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+
+            modelBuilder.Entity("DataLayer.Series", b =>
+                {
+                    b.Navigation("BooksLink");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

Source/DataLayer.Postgres/Migrations/20260427201825_ReAddCategoryName2.cs

@@ -0,0 +1,26 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace DataLayer.Postgres.Migrations;
+
+/// <inheritdoc />
+public partial class ReAddCategoryName2 : Migration
+{
+	/// <inheritdoc />
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.AddColumn<string>(
+			name: "Name",
+			table: "Categories",
+			type: "text",
+			nullable: false,
+			defaultValue: "");
+	}
+
+	/// <inheritdoc />
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropColumn(
+			name: "Name",
+			table: "Categories");
+	}
+}

Source/DataLayer.Postgres/Migrations/LibationContextModelSnapshot.cs

@@ -17,7 +17,7 @@ namespace DataLayer.Postgres.Migrations
         {
 #pragma warning disable 612, 618
             modelBuilder
-                .HasAnnotation("ProductVersion", "9.0.8")
+                .HasAnnotation("ProductVersion", "10.0.2")
                 .HasAnnotation("Relational:MaxIdentifierLength", 63);
 
             NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
@@ -46,6 +46,7 @@ namespace DataLayer.Postgres.Migrations
                     NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("BookId"));
 
                     b.Property<string>("AudibleProductId")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<int>("ContentType")
@@ -55,6 +56,7 @@ namespace DataLayer.Postgres.Migrations
                         .HasColumnType("timestamp without time zone");
 
                     b.Property<string>("Description")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<bool>("IsAbridged")
@@ -70,6 +72,7 @@ namespace DataLayer.Postgres.Migrations
                         .HasColumnType("integer");
 
                     b.Property<string>("Locale")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<string>("PictureId")
@@ -79,9 +82,11 @@ namespace DataLayer.Postgres.Migrations
                         .HasColumnType("text");
 
                     b.Property<string>("Subtitle")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<string>("Title")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.HasKey("BookId");
@@ -140,9 +145,11 @@ namespace DataLayer.Postgres.Migrations
                     NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("CategoryId"));
 
                     b.Property<string>("AudibleCategoryId")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<string>("Name")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.HasKey("CategoryId");
@@ -177,6 +184,7 @@ namespace DataLayer.Postgres.Migrations
                         .HasColumnType("text");
 
                     b.Property<string>("Name")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.HasKey("ContributorId");
@@ -202,6 +210,7 @@ namespace DataLayer.Postgres.Migrations
                         .HasColumnType("boolean");
 
                     b.Property<string>("Account")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<DateTime>("DateAdded")
@@ -210,6 +219,9 @@ namespace DataLayer.Postgres.Migrations
                     b.Property<DateTime?>("IncludedUntil")
                         .HasColumnType("timestamp without time zone");
 
+                    b.Property<bool>("IsAudiblePlus")
+                        .HasColumnType("boolean");
+
                     b.Property<bool>("IsDeleted")
                         .HasColumnType("boolean");
 
@@ -227,6 +239,7 @@ namespace DataLayer.Postgres.Migrations
                     NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("SeriesId"));
 
                     b.Property<string>("AudibleSeriesId")
+                        .IsRequired()
                         .HasColumnType("text");
 
                     b.Property<string>("Name")
@@ -310,6 +323,7 @@ namespace DataLayer.Postgres.Migrations
                                 .HasColumnType("integer");
 
                             b1.Property<string>("Url")
+                                .IsRequired()
                                 .HasColumnType("text");
 
                             b1.HasKey("SupplementId");
@@ -351,6 +365,7 @@ namespace DataLayer.Postgres.Migrations
                                 .HasColumnType("integer");
 
                             b1.Property<string>("Tags")
+                                .IsRequired()
                                 .HasColumnType("text");
 
                             b1.HasKey("BookId");
@@ -384,14 +399,17 @@ namespace DataLayer.Postgres.Migrations
 
                             b1.Navigation("Book");
 
-                            b1.Navigation("Rating");
+                            b1.Navigation("Rating")
+                                .IsRequired();
                         });
 
-                    b.Navigation("Rating");
+                    b.Navigation("Rating")
+                        .IsRequired();
 
                     b.Navigation("Supplements");
 
-                    b.Navigation("UserDefinedItem");
+                    b.Navigation("UserDefinedItem")
+                        .IsRequired();
                 });
 
             modelBuilder.Entity("DataLayer.BookCategory", b =>

Source/DataLayer.Postgres/PostgresContextFactory.cs

@@ -1,12 +1,11 @@
 using Microsoft.EntityFrameworkCore.Design;
 
-namespace DataLayer.Postgres
+namespace DataLayer.Postgres;
+
+public class PostgresContextFactory : IDesignTimeDbContextFactory<LibationContext>
 {
-    public class PostgresContextFactory : IDesignTimeDbContextFactory<LibationContext>
-    {
-        public LibationContext CreateDbContext(string[] args)
-        {
-            return LibationContextFactory.CreatePostgres(string.Empty);
-        }
-    }
+	public LibationContext CreateDbContext(string[] args)
+	{
+		return LibationContextFactory.CreatePostgres(string.Empty);
+	}
 }

Source/DataLayer.Sqlite/DataLayer.Sqlite.csproj

@@ -9,11 +9,11 @@
     <OutputType>Library</OutputType>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0">
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.7">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0">
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.7">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

Source/DataLayer.Sqlite/Migrations/20191125182309_Fresh.cs

@@ -1,294 +1,293 @@
-using System;
-using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Migrations;
+using System;
 
-namespace DataLayer.Migrations
+namespace DataLayer.Migrations;
+
+public partial class Fresh : Migration
 {
-    public partial class Fresh : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "Categories",
-                columns: table => new
-                {
-                    CategoryId = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    AudibleCategoryId = table.Column<string>(nullable: true),
-                    Name = table.Column<string>(nullable: true),
-                    ParentCategoryCategoryId = table.Column<int>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Categories", x => x.CategoryId);
-                    table.ForeignKey(
-                        name: "FK_Categories_Categories_ParentCategoryCategoryId",
-                        column: x => x.ParentCategoryCategoryId,
-                        principalTable: "Categories",
-                        principalColumn: "CategoryId",
-                        onDelete: ReferentialAction.Restrict);
-                });
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.CreateTable(
+			name: "Categories",
+			columns: table => new
+			{
+				CategoryId = table.Column<int>(nullable: false)
+					.Annotation("Sqlite:Autoincrement", true),
+				AudibleCategoryId = table.Column<string>(nullable: true),
+				Name = table.Column<string>(nullable: true),
+				ParentCategoryCategoryId = table.Column<int>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Categories", x => x.CategoryId);
+				table.ForeignKey(
+					name: "FK_Categories_Categories_ParentCategoryCategoryId",
+					column: x => x.ParentCategoryCategoryId,
+					principalTable: "Categories",
+					principalColumn: "CategoryId",
+					onDelete: ReferentialAction.Restrict);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Contributors",
-                columns: table => new
-                {
-                    ContributorId = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Name = table.Column<string>(nullable: true),
-                    AudibleContributorId = table.Column<string>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Contributors", x => x.ContributorId);
-                });
+		migrationBuilder.CreateTable(
+			name: "Contributors",
+			columns: table => new
+			{
+				ContributorId = table.Column<int>(nullable: false)
+					.Annotation("Sqlite:Autoincrement", true),
+				Name = table.Column<string>(nullable: true),
+				AudibleContributorId = table.Column<string>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Contributors", x => x.ContributorId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Series",
-                columns: table => new
-                {
-                    SeriesId = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    AudibleSeriesId = table.Column<string>(nullable: true),
-                    Name = table.Column<string>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Series", x => x.SeriesId);
-                });
+		migrationBuilder.CreateTable(
+			name: "Series",
+			columns: table => new
+			{
+				SeriesId = table.Column<int>(nullable: false)
+					.Annotation("Sqlite:Autoincrement", true),
+				AudibleSeriesId = table.Column<string>(nullable: true),
+				Name = table.Column<string>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Series", x => x.SeriesId);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Books",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    AudibleProductId = table.Column<string>(nullable: true),
-                    Title = table.Column<string>(nullable: true),
-                    Description = table.Column<string>(nullable: true),
-                    LengthInMinutes = table.Column<int>(nullable: false),
-                    PictureId = table.Column<string>(nullable: true),
-                    IsAbridged = table.Column<bool>(nullable: false),
-                    DatePublished = table.Column<DateTime>(nullable: true),
-                    CategoryId = table.Column<int>(nullable: false),
-                    Rating_OverallRating = table.Column<float>(nullable: true),
-                    Rating_PerformanceRating = table.Column<float>(nullable: true),
-                    Rating_StoryRating = table.Column<float>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Books", x => x.BookId);
-                    table.ForeignKey(
-                        name: "FK_Books_Categories_CategoryId",
-                        column: x => x.CategoryId,
-                        principalTable: "Categories",
-                        principalColumn: "CategoryId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "Books",
+			columns: table => new
+			{
+				BookId = table.Column<int>(nullable: false)
+					.Annotation("Sqlite:Autoincrement", true),
+				AudibleProductId = table.Column<string>(nullable: true),
+				Title = table.Column<string>(nullable: true),
+				Description = table.Column<string>(nullable: true),
+				LengthInMinutes = table.Column<int>(nullable: false),
+				PictureId = table.Column<string>(nullable: true),
+				IsAbridged = table.Column<bool>(nullable: false),
+				DatePublished = table.Column<DateTime>(nullable: true),
+				CategoryId = table.Column<int>(nullable: false),
+				Rating_OverallRating = table.Column<float>(nullable: true),
+				Rating_PerformanceRating = table.Column<float>(nullable: true),
+				Rating_StoryRating = table.Column<float>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Books", x => x.BookId);
+				table.ForeignKey(
+					name: "FK_Books_Categories_CategoryId",
+					column: x => x.CategoryId,
+					principalTable: "Categories",
+					principalColumn: "CategoryId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "BookContributor",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(nullable: false),
-                    ContributorId = table.Column<int>(nullable: false),
-                    Role = table.Column<int>(nullable: false),
-                    Order = table.Column<byte>(nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_BookContributor", x => new { x.BookId, x.ContributorId, x.Role });
-                    table.ForeignKey(
-                        name: "FK_BookContributor_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_BookContributor_Contributors_ContributorId",
-                        column: x => x.ContributorId,
-                        principalTable: "Contributors",
-                        principalColumn: "ContributorId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "BookContributor",
+			columns: table => new
+			{
+				BookId = table.Column<int>(nullable: false),
+				ContributorId = table.Column<int>(nullable: false),
+				Role = table.Column<int>(nullable: false),
+				Order = table.Column<byte>(nullable: false)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_BookContributor", x => new { x.BookId, x.ContributorId, x.Role });
+				table.ForeignKey(
+					name: "FK_BookContributor_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+				table.ForeignKey(
+					name: "FK_BookContributor_Contributors_ContributorId",
+					column: x => x.ContributorId,
+					principalTable: "Contributors",
+					principalColumn: "ContributorId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Library",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(nullable: false),
-                    DateAdded = table.Column<DateTime>(nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Library", x => x.BookId);
-                    table.ForeignKey(
-                        name: "FK_Library_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "Library",
+			columns: table => new
+			{
+				BookId = table.Column<int>(nullable: false),
+				DateAdded = table.Column<DateTime>(nullable: false)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Library", x => x.BookId);
+				table.ForeignKey(
+					name: "FK_Library_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "SeriesBook",
-                columns: table => new
-                {
-                    SeriesId = table.Column<int>(nullable: false),
-                    BookId = table.Column<int>(nullable: false),
-                    Index = table.Column<float>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_SeriesBook", x => new { x.SeriesId, x.BookId });
-                    table.ForeignKey(
-                        name: "FK_SeriesBook_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                    table.ForeignKey(
-                        name: "FK_SeriesBook_Series_SeriesId",
-                        column: x => x.SeriesId,
-                        principalTable: "Series",
-                        principalColumn: "SeriesId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "SeriesBook",
+			columns: table => new
+			{
+				SeriesId = table.Column<int>(nullable: false),
+				BookId = table.Column<int>(nullable: false),
+				Index = table.Column<float>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_SeriesBook", x => new { x.SeriesId, x.BookId });
+				table.ForeignKey(
+					name: "FK_SeriesBook_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+				table.ForeignKey(
+					name: "FK_SeriesBook_Series_SeriesId",
+					column: x => x.SeriesId,
+					principalTable: "Series",
+					principalColumn: "SeriesId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "Supplement",
-                columns: table => new
-                {
-                    SupplementId = table.Column<int>(nullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    BookId = table.Column<int>(nullable: false),
-                    Url = table.Column<string>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Supplement", x => x.SupplementId);
-                    table.ForeignKey(
-                        name: "FK_Supplement_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "Supplement",
+			columns: table => new
+			{
+				SupplementId = table.Column<int>(nullable: false)
+					.Annotation("Sqlite:Autoincrement", true),
+				BookId = table.Column<int>(nullable: false),
+				Url = table.Column<string>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_Supplement", x => x.SupplementId);
+				table.ForeignKey(
+					name: "FK_Supplement_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.CreateTable(
-                name: "UserDefinedItem",
-                columns: table => new
-                {
-                    BookId = table.Column<int>(nullable: false),
-                    Tags = table.Column<string>(nullable: true),
-                    Rating_OverallRating = table.Column<float>(nullable: true),
-                    Rating_PerformanceRating = table.Column<float>(nullable: true),
-                    Rating_StoryRating = table.Column<float>(nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_UserDefinedItem", x => x.BookId);
-                    table.ForeignKey(
-                        name: "FK_UserDefinedItem_Books_BookId",
-                        column: x => x.BookId,
-                        principalTable: "Books",
-                        principalColumn: "BookId",
-                        onDelete: ReferentialAction.Cascade);
-                });
+		migrationBuilder.CreateTable(
+			name: "UserDefinedItem",
+			columns: table => new
+			{
+				BookId = table.Column<int>(nullable: false),
+				Tags = table.Column<string>(nullable: true),
+				Rating_OverallRating = table.Column<float>(nullable: true),
+				Rating_PerformanceRating = table.Column<float>(nullable: true),
+				Rating_StoryRating = table.Column<float>(nullable: true)
+			},
+			constraints: table =>
+			{
+				table.PrimaryKey("PK_UserDefinedItem", x => x.BookId);
+				table.ForeignKey(
+					name: "FK_UserDefinedItem_Books_BookId",
+					column: x => x.BookId,
+					principalTable: "Books",
+					principalColumn: "BookId",
+					onDelete: ReferentialAction.Cascade);
+			});
 
-            migrationBuilder.InsertData(
-                table: "Categories",
-                columns: new[] { "CategoryId", "AudibleCategoryId", "Name", "ParentCategoryCategoryId" },
-                values: new object[] { -1, "", "", null });
+		migrationBuilder.InsertData(
+			table: "Categories",
+			columns: new[] { "CategoryId", "AudibleCategoryId", "Name", "ParentCategoryCategoryId" },
+			values: new object[] { -1, "", "", null });
 
-            migrationBuilder.InsertData(
-                table: "Contributors",
-                columns: new[] { "ContributorId", "AudibleContributorId", "Name" },
-                values: new object[] { -1, null, "" });
+		migrationBuilder.InsertData(
+			table: "Contributors",
+			columns: new[] { "ContributorId", "AudibleContributorId", "Name" },
+			values: new object[] { -1, null, "" });
 
-            migrationBuilder.CreateIndex(
-                name: "IX_BookContributor_BookId",
-                table: "BookContributor",
-                column: "BookId");
+		migrationBuilder.CreateIndex(
+			name: "IX_BookContributor_BookId",
+			table: "BookContributor",
+			column: "BookId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_BookContributor_ContributorId",
-                table: "BookContributor",
-                column: "ContributorId");
+		migrationBuilder.CreateIndex(
+			name: "IX_BookContributor_ContributorId",
+			table: "BookContributor",
+			column: "ContributorId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Books_AudibleProductId",
-                table: "Books",
-                column: "AudibleProductId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Books_AudibleProductId",
+			table: "Books",
+			column: "AudibleProductId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Books_CategoryId",
-                table: "Books",
-                column: "CategoryId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Books_CategoryId",
+			table: "Books",
+			column: "CategoryId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Categories_AudibleCategoryId",
-                table: "Categories",
-                column: "AudibleCategoryId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Categories_AudibleCategoryId",
+			table: "Categories",
+			column: "AudibleCategoryId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Categories_ParentCategoryCategoryId",
-                table: "Categories",
-                column: "ParentCategoryCategoryId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Categories_ParentCategoryCategoryId",
+			table: "Categories",
+			column: "ParentCategoryCategoryId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Contributors_Name",
-                table: "Contributors",
-                column: "Name");
+		migrationBuilder.CreateIndex(
+			name: "IX_Contributors_Name",
+			table: "Contributors",
+			column: "Name");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Series_AudibleSeriesId",
-                table: "Series",
-                column: "AudibleSeriesId");
+		migrationBuilder.CreateIndex(
+			name: "IX_Series_AudibleSeriesId",
+			table: "Series",
+			column: "AudibleSeriesId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_SeriesBook_BookId",
-                table: "SeriesBook",
-                column: "BookId");
+		migrationBuilder.CreateIndex(
+			name: "IX_SeriesBook_BookId",
+			table: "SeriesBook",
+			column: "BookId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_SeriesBook_SeriesId",
-                table: "SeriesBook",
-                column: "SeriesId");
+		migrationBuilder.CreateIndex(
+			name: "IX_SeriesBook_SeriesId",
+			table: "SeriesBook",
+			column: "SeriesId");
 
-            migrationBuilder.CreateIndex(
-                name: "IX_Supplement_BookId",
-                table: "Supplement",
-                column: "BookId");
-        }
+		migrationBuilder.CreateIndex(
+			name: "IX_Supplement_BookId",
+			table: "Supplement",
+			column: "BookId");
+	}
 
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable(
-                name: "BookContributor");
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropTable(
+			name: "BookContributor");
 
-            migrationBuilder.DropTable(
-                name: "Library");
+		migrationBuilder.DropTable(
+			name: "Library");
 
-            migrationBuilder.DropTable(
-                name: "SeriesBook");
+		migrationBuilder.DropTable(
+			name: "SeriesBook");
 
-            migrationBuilder.DropTable(
-                name: "Supplement");
+		migrationBuilder.DropTable(
+			name: "Supplement");
 
-            migrationBuilder.DropTable(
-                name: "UserDefinedItem");
+		migrationBuilder.DropTable(
+			name: "UserDefinedItem");
 
-            migrationBuilder.DropTable(
-                name: "Contributors");
+		migrationBuilder.DropTable(
+			name: "Contributors");
 
-            migrationBuilder.DropTable(
-                name: "Series");
+		migrationBuilder.DropTable(
+			name: "Series");
 
-            migrationBuilder.DropTable(
-                name: "Books");
+		migrationBuilder.DropTable(
+			name: "Books");
 
-            migrationBuilder.DropTable(
-                name: "Categories");
-        }
-    }
+		migrationBuilder.DropTable(
+			name: "Categories");
+	}
 }

Source/DataLayer.Sqlite/Migrations/20200812152646_AddLocaleAndAccount.cs

@@ -1,31 +1,30 @@
 using Microsoft.EntityFrameworkCore.Migrations;
 
-namespace DataLayer.Migrations
+namespace DataLayer.Migrations;
+
+public partial class AddLocaleAndAccount : Migration
 {
-    public partial class AddLocaleAndAccount : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<string>(
-                name: "Account",
-                table: "Library",
-                nullable: true);
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.AddColumn<string>(
+			name: "Account",
+			table: "Library",
+			nullable: true);
 
-            migrationBuilder.AddColumn<string>(
-                name: "Locale",
-                table: "Books",
-                nullable: true);
-        }
+		migrationBuilder.AddColumn<string>(
+			name: "Locale",
+			table: "Books",
+			nullable: true);
+	}
 
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "Account",
-                table: "Library");
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropColumn(
+			name: "Account",
+			table: "Library");
 
-            migrationBuilder.DropColumn(
-                name: "Locale",
-                table: "Books");
-        }
-    }
+		migrationBuilder.DropColumn(
+			name: "Locale",
+			table: "Books");
+	}
 }

Source/DataLayer.Sqlite/Migrations/20210619030017_AddAaxcDecryptionKeys.cs

@@ -1,33 +1,32 @@
 using Microsoft.EntityFrameworkCore.Migrations;
 
-namespace DataLayer.Migrations
+namespace DataLayer.Migrations;
+
+public partial class AddAaxcDecryptionKeys : Migration
 {
-    public partial class AddAaxcDecryptionKeys : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.AddColumn<string>(
-                name: "AudibleIV",
-                table: "Books",
-                type: "TEXT",
-                nullable: true);
+	protected override void Up(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.AddColumn<string>(
+			name: "AudibleIV",
+			table: "Books",
+			type: "TEXT",
+			nullable: true);
 
-            migrationBuilder.AddColumn<string>(
-                name: "AudibleKey",
-                table: "Books",
-                type: "TEXT",
-                nullable: true);
-        }
+		migrationBuilder.AddColumn<string>(
+			name: "AudibleKey",
+			table: "Books",
+			type: "TEXT",
+			nullable: true);
+	}
 
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropColumn(
-                name: "AudibleIV",
-                table: "Books");
+	protected override void Down(MigrationBuilder migrationBuilder)
+	{
+		migrationBuilder.DropColumn(
+			name: "AudibleIV",
+			table: "Books");
 
-            migrationBuilder.DropColumn(
-                name: "AudibleKey",
-                table: "Books");
-        }
-    }
+		migrationBuilder.DropColumn(
+			name: "AudibleKey",
+			table: "Books");
+	}
 }